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WELCOME ТО 
THE OFFICIAL 
MAGAZINE 


appy new year! Every January, we welcome 
a huge number of brand new Raspberry Pi А 2 YD 
users. So come on in, take a seat, and don't 7 "TL VS | FOR PERRY ELE 
mind the robots (they don’t normally bite). 3 = 
First of all, have you seen our new Raspberry урке аш їй т 
Pi for Newbies feature (page 16)? It’s the perfect SUBSCRIBE & eee ЗЕ 8 
welcome for newcomers. You see, the Raspberry Рі саа 
community is massive. Our calendar is packed with SEE PAGE 28 FOR DETAILS 
events, like Pi Jams, Formula Pi, and Pi Wars. 
Raspberry Pi isn’t just a computer and a charity. 
We’re acommunity of people who love making 
stuff with programmable computers. So if you want THIS MONTH: 
to learn about digital making with Raspberry Pi, 
then you’ve found the right place. 


And for all you regulars... Don’t worry! We have a 16 RASPBERRY PI FOR NEWBIES 


Everything you need to know about the community 


TẸ 


magazine packed with project ideas, and a big look 


at AIY Projects: Vision Kit (page 62). Discover how 30 APHEX TWIN MIDIMUTANT 


to set it add smart vision to your projects, and : А 
: Mp bns y proj i Megastar talks about new Raspberry Pi music tool 
how artificial neural networks are created. 


We go from welcoming newcomers to building 62 AIY PROJECTS: VISION KIT 

artificial neural networks. How neat is that? Add Google's machine vision tech to your projects 

Lucy Hattersley 86 THIS MONTH IN PI 
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TUTORIALS 


> PI 101: BUILD A SERVER 38 


Use a Raspberry Pi as a small but powerful server 


> RING IN THE NEW YEAR 40 


Build a tower of bells for your New Year's party 


» BEAT A CHESS PUZZLE 46 


Solve the eight queens problem and win $1 million! 


»CREATEA CHRISTMAS GAME 50 


Can you remember the pattern on the jazzy jumper? 


> MAKE GAMES IN C++ PART 1 54 


Developing games on the Raspberry Pi in С++ 


Connect two Zero-sized pHATs to one Pi 
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RASPBERRY PI 
FOR NEWBIES 


BIXELS 


Ras 


A display for 
biocomputing 
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PI-POWERED 
Al TEASMADE 


STARS IN CHANNEL 4 SHOW 


Smart teasmade built using Raspberry Pi features in Channel 4 show: 
Guy Martin Versus the Robot Car 


Raspberry Pi was taken for 
a test run by speed junkie 
Guy Martin in Channel 4’s 


recent documentary, Guy Martin 
Versus the Robot Car. 

The Pi powered tea- making 
robot, ingeniously named 


Below R2-Tea2 

not only uses and 
understands natural 
language, but uses 
Al to select the 
correct mug, tea, 
milk content, and 
brew time 


6 | Марі January 2018 


R2-Tea2, was designed and built 
by Huddersfield? s Running in 

the Halls (RITH), a design and 
development studio whose 
*primary focus is designing and 
developing web and mobile apps, 
games and installations" according 


to RITH co-founder and director, 
Sam Croft. 

RITH's brief was “to demonstrate 
how AI could be used in technology 
that is readily accessible to anyone 
that has an interest in physical 
computing," Sam tells us. 


Guy doesn't have a smartphone and uses a 
15-year-old Nokia. This limited our chatbot 
idea to using SMS text messages 


The idea to make a teasmade 
came from Guy's love of tea, 
with the aim that Guy could 
interact with the robot tea- maker 
“through some kind of chatbot 
that would make decisions, based 
on his [Guy's] responses in the 
conversation, about what kind of 
tea to make," Sam explains. 

However, Sam reveals that *Guy 
doesn't have a smartphone and 
uses a 15-year-old Nokia. This 
limited our chatbot idea to using 
SMS text messages." 


Robo-tea 

R2-Tea2 has *two core 
components," Sam continues: 
*The making robot [and] the 
chatbot, with language processing 
and basic АТ.” The actual robot was 
based around the Pi, hooked up to 
a £12 Adafruit 16- channel PCA9685 
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PI-POWERED Al TEASMADE STARS IN CHANNEL 4 SHOW 


Guy Martin and RITH's Alison Cox filming the show 


News 


ALSO BY RITH 


PWM/servo driver board and two 
dual H-bridge motor drivers. As 
“the budget wasn’t huge” for 
R2-Tea2, components needed to be 
cheap or easily sourced. 

“We had one script [to control 
the robot] that sequenced the 
firing off of all the separate control 
scripts, which were nothing more 
complex than sending high and 
low signals to the correct pins with 
the correct delays,” recalls Sam. 


Look north 


It was important that R2-Tea2 
could understand Guy’s “famous 
Northern turn of phrase,” as Sam 
puts it, so the language-processing 
element was programmed to 
comprehend some of Guy’s more 
unusual idioms. 

RITH used Twilio (twilio.com) 
to handle the SMS messaging, 


and Google Dialogflow for the 
conversational interface. RITH 
then needed a webhook to send 
texts from Guy’s phone toa 
Python application running on the 
Raspberry Pi. “To achieve this,” 
Sam explains, “we had to expose 
our localhost server to the internet 
by using a service called ngrok.” 
See ngrok.com for details. 

The AI also analysed Guy’s day 
to “approximate his current stress 
level”. Blending SMS conversation 
and Guy's activities, R2-Tea2 chose 
*what kind of cup to use, which 
kind of tea, how much (if any) 
milk, and how long the tea should 
brew for," Sam reveals. 

R2-Tea2 was built by two people 
at RITH: co-founder and director 
Alison Cox built the robot and the 
Python script while Sam built the 
chatbot portion. 


Most of the Raspberry Pi's GPIO pins were needed 
to control the tea-making device 
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Well-known gadgeteer Stephen Fry was invited 

to play Battleships with a custom RITH build for 
Channel 4's Gadget Man show. The board was the side 
of a derelict building, projected onto from London's 
ExCeL exhibition centre. "This was a multiplayer, 
crowd-based дате," RITH Partner Sam Croft tells us, 
"that anyone in the area could play." 


"We worked with Bandai Namco," Sam says, to make 
a Pac-Man game for Channel 5's The Gadget Show 
"that fitted around the windows of the Millennium 
Mills building" near ExCeL. The project was awarded 
(and still holds) a Guinness World Record for largest 
architectural projection-mapped game. at 218.65 тг. 


RITH developed "a solution for controlling a full-size 
digger with a Nod ring," a gestural controller that 
fits on the finger, for The Gadget Show. "We created 
a simple servo-driven arm controlled by computer 
to interpret the signals coming from the ring," Sam 
explains. "The digger arm essentially followed the 
movement of the user's arm." 
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ИЛИ BIXELS: THE BIOCOMPUTING DISPLAY 


THE BIOCOMPUTING DISPLAY 


Irish firm using DNA to play Tetris 


Bixels incorporates almost every 
aspect of aSTEAM curriculum 


Technology has launched 
a Kickstarter campaign for 
a “world-first demonstration of a 
DNA programmed bio-computer 
that can play Tetris”. 

Bixels is an 8x8 grid of 
*bio-pixels' that can be controlled 
from a smartphone. As you can 
electronically control which Bixels 
are lit, the Bixels act just like the 
pixels in your screen. 

The DNA is synthetically 
replicated from the same DNA 


Nn 


in a single workshop 


Below Mix actual 
DNA with a special 
'cell-free' liquid 

in each test tube 
to create a light- 
emitting protein 


that allows a jellyfish to glow 
green - no jellyfish are harmed 
to make Bixels. 

Cell-Free Technology CEO Dr 
Thomas Meany tells us, “Bixels 
is a hugely valuable resource for 
anyone who needs a low-cost way 
to study fluorescent proteins ina 
lab, but our real target is STEAM 
educators.” As Thomas points out, 
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rish bio-tech firm Cell-Free 


As you control which Bixels are 
lit at any given time, you can 
play Tetris on a biocomputer! 


Bixels “incorporates almost every 
aspect of a STEAM curriculum ina 
single workshop.” 


DNA for the masses 

Bixels places an 8x8 grid of small 
test tubes (called PCR tubes) onto 
an 8x8 grid of RGB NeoPixels 
(controlled by an Adafruit Bluefruit 
Feather). By mixing the liquid in 


the two coloured vials of the kit 
in each PCR tube, you create a 
mixture that emits green when the 
NeoPixel beneath shines blue. 
Or, as Thomas explains (very 
patiently), “The blue vial contains 
cell-free extract which has the 
nano-machinery (ribosomes, RNA 
polymerase, and transcription 
factors) that, when the DNA is 
added, can be programmed to 
produce a protein (in our case 
fluorescent protein)”. A coloured 
filter within the Bixels housing 
ensures only the light emitted by 
the protein is seen. 
Bixels is safe to play with and use 
because of the unique ‘cell-free’ 
technology developed by Cell-Free 
Technology. The ‘bacteriophage 
infection’ used breaks down 
cell walls without harming the 
contents, leaving you witha 
liquid that can be biologically 
programmed “without the fear 
of a bacteria or other organism 
[forming],” confirms Thomas. 
Bixels has a target of €9267 
(£8166), with a basic Bixel Solo kit 
only costing €90 (£79). 
See kck.st/2BwjZyc. 
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Raspberry Pi for professional applications 


v? 


SU QUO 


Strato Pi enhances the Raspberry Pi and the Compute 
Module with hardware features that make them 
suitable for use in professional applications where 
reliability and service continuity are key requirements. 


CE/ROHS 
CERTIFIED HARDWARE 


WATCHDOG DIN-RAIL 
CASE 

2 KZ» 
Coa’ 
RS-232 / 


RS-485 


WIDE RANGE 
POWER SUPPLY 


v2 
UJ O 
lono Pi is a versatile I/O module that 
combines digital and analog standard 


interfaces with the powerful 
computing core of the Raspberry Pi. 


WDD Wa ЛЕ; 


mu BIB | 
ШШ 
a. 


it 
[=] 


er ЕЕЕ А Ь А В 5 | www.sferalabs.cc 


442 TWAT le к&змазчазмзу. 


J What's inside? 


Below There are plenty of 
Pi-based puzzles, activities, 
and fun inside! 


SCRATCH @ PUZZLES © COMIC & MORE: 


Make a pHAT mash-up with RasPiO’s 


latest creation: the FullpHAT 


10 


asP.iO's latest HAT allows 
you to attach two Zero- 
sized pHATs to a single Pi. 
The FullpHAT also exposes all the 
unused headers and connectors to 
give you maximum flexibility with 
your build. 

Alex Eames, of RasPi.TV and 
RasPiO, tells us: “I tend to design 
and make something that I want to 
use," explaining that he wanted to 


crowdfund the FullpHAT to *assess 


the demand". There have been 
over 400 orders of the FullpHAT, 
twice the initial target. 

Alex suggests a few uses for 
the FullpHAT: a RasPiO InsPiRing 
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FREE RASPBERRY PI ANNUAL / TWO PHATS ON ONE PI 


FREE 


RASPBERRY PI 


ANNUAL 


Holiday fun with Raspberry Pi 


oly GPIO! Will the evil Dr 

Bluescreen succeed with 

her villainous plan, or will 
The Founders rescue the children 
of Earth from a fate worse than 
Excel? Find out in the first ever 
Raspberry Pi Annual! 
This surprise Christmas present 
for subscribers of The MagPi is 
"packed with all the great word 
and picture puzzles you'd expect 
from any fun-filled annual, but 
also has a guide on getting started 
with the Raspberry Pi, as well as 
lots of fun projects using Scratch, 


TWO PHATS ON 


and a Pimoroni Inky pHAT *go 
well together ... With an Analog 
Zero and DAC Zero, you can play 
music or sounds while reading 
sensors." As you have all the pins 
broken out, it's easy to add extra 
components to your build. 


Python, Minecraft, and more," 
says Russell Barnes, Raspberry Pi 
Publishing Director. 

If you're not yet a subscriber of 
The MagPi, don’t panic: you can still 
bag yourself a copy of the Raspberry 
Pi Annual by signing up to a 
12-month subscription of The MagPi 
before 24 January. You'll also receive 
the usual subscriber gift of a free 
Raspberry Pi Zero W (with case and 
cable). Just head to magpi.cc/Subst1. 

Or you can buy a copy of the 
Raspberry Pi Annual for just £7.99 
from store.rpipress.cc. 


PI 


The FullpHAT 
allows you to attach 
two pHATs to one Pi 

- a Pi 3, in this case 


As with any HAT stack, you must 
avoid potential conflicts, *but on 
Gadgetoid's pinout.xyz you can 
check to see which pins/ports most 
pHATS use" — great tip, Alex! 

The FullpHAT costs only £8, 
from magpi.cc/2ku3dfc. 
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WEBKIOSK 


L3 


Г 


Completes line-up of digital signage 


and kiosk OSes 


ignage and kiosk OS 

specialist Binary Emotions 

has released Raspberry 
WebKiosk 7, completing the 
migration of its bespoke digital 
signage and kiosk operating 
systems to Raspbian Stretch. 
According to Binary Emotions’ 
Marco Buratto, “Raspberry 
WebkKiosk is designed for the 
cheapest possible web kiosks and 
multi-user web workstations,” 
making the OS ideal for computer 
terminals in cafes, waiting areas, 
libraries, and other public spaces. 

Marco adds: “Raspberry 

WebKiosk is a browser-only ... 
hacker-proof operating system 
[which uses Chromium and] 


raspberrypi.org/magpi 


supports printing. System 
parameters are set by a user- 
friendly web interface". 

Raspberry WebkKiosk is the last 
of Binary Emotions’ offerings to 
be updated to Raspbian Stretch, 
with the Raspberry Digital Signage 
and Raspberry Slideshow OSes 
already updated. 

While Raspbian Digital Signage 
is intended for a permanent, 
internet-enabled digital sign or 
display, Raspberry Slideshow is 
*focused on quick-to-set-up 
image and video slideshows" 
running image and videos from a 
USB drive. 

You can download these OSes for 
free from binaryemotions.com. 


Use this free, bespoke 
OS to make a Pi-based 
internet kiosk 


The stories we shared 
that flew around the world 


magpi.cc/2Aowbfj 


Following the screaming success of Google's 
AIY Projects Voice Kit comes the new Vision Kit. 
Its 'VisionBonnet' has a Movidius MA2450 vision 
processing chip for on-board Al processing. 


magpi.cc/2noe3dU 


Adafruit's read-only Pi script is ideal for anyone 
building a 'don't touch again' Pi system. Whether that's 
for a digital sign or loT device, the script ensures that 
power failure won't corrupt the installation. 


magpi.cc/2joSSag 


Simplicity is sometimes best - why code a web-based 
push-alert system when you can just use a few LEDs 
and a Sharpie to find out what's what? The Pi Hut's 
Status Board offers exactly that. 
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NEW RASPBERRY PI 
DESKTOP FOR X80 


Updated version for your non-Raspberry Pi PC 


There are also new features 
that make Raspberry Pi Desktop 
more useful. PiServer shares the 
operating system of a central 
computer with multiple Pis, 
meaning that each Pi is running 
exactly the same software. That 
should be useful for teachers when 
guiding a lesson, or for CoderDojo 


he Debian with Raspberry 

Pi Desktop operating 

system for x86 computers 
(that’s your common laptop or 
desktop) has been updated to 
Debian Stretch. 


can use the Zero’s GPIO pins in 
either Python or Scratch 2 once 
you’ve installed and configured 
usbbootgui — see the full 
instructions at magpi.cc/2kvGsY5. 
Laptop users now get a battery 
monitor. “Eben [Upton] runs 
our desktop on his Mac,” says 
Raspberry Pi UX Engineer Simon 


Below The latest 
version of Debian 
with Raspberry Pi 
Desktop includes 
a couple of new 
applications for 
makers, tinkerers, 
and teachers 


AIMS TO 
MAKE IOT EASY 


and Code Club leaders. See our 
tutorial on page 38 for information 
on how to use PiServer. 

There’s also a new GPIO 
expander application. The 
problem with a conventional 
computer is the lack of GPIO 
pins, but the GPIO expander 
enables it to access the pins of a 
Pi Zero connected via USB. You 


Long. “And he was becoming 
slightly irritated by having to 
keep rebooting into macOS just 
to check whether his battery was 
about to die — so fixing this was 
a priority.” 

You can download the 
latest version of Debian with 
Raspberry Pi Desktop from 
magpi.cc/2joTqNm. 


Modular hardware and software design Call ^ Message Camera 
iTalk is an almost ‘plug Gajender Singh, CEO of SB A O 
and play’ approach to IoT Components, is keen to explain } law 
and automation, and can that while PiTalk is a “multi- Internet Gallery "bes 
be modified, adapted and added to appliance communication 9s 
as you see fit. As long as it hits its platform [that can] interface with A 
Kickstarter target of £1000, that is analogue sensors and, of course, С) S Ө 
— see kck.st/2Bf5EGg. yenefits from the flexibility of the Stopwatch iin | 
Raspberry Pi,” its real selling point " Calculator 
s that “it’s intended for people to 
ise with no or minimum physical << Q >> 
-emodelling.” In other words, no —— 
soldering iron required. CICEIT ج‎ 


As well as not requiring any 
iardware skills to set up, Gajender 
‘ells us, “I didn’t want getting it 
1р and running to be the end of 
‘he interaction," so PiTalk comes 
with a ready-to-go software suite. 


“The interface is all about making 
it immediately usable without 
tying users down to a single use,” 


he confirms. 


PiTalk isa 
modular loT and 
automation platform, 
with little setup skill 
needed - even the 
screen is optional 
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THE TAKE-EVERYWHERE TESTING TOOL 


THE TAKE-EVERY WHERE 


TESTING TOOL 


BitScope Micro ‘no-brainer’ а HAT to read what's 
for travelling engineers piin realtime а 


Pi in real time 
itScope’s latest scope offers “almost 
everything you're likely to need” for testing 
and measurement, according to Bruce 
Tulloch, BitScope CEO, in a package not much longer 
than a Pi 3 and less than half as wide. 

The BitScope Micro (magpi.cc/2kuJNGS) “has a 
pair of analogue channels, six logic channels, and a 
waveform generator," says Bruce, but it also includes 
“a high-speed A/D, D/A, compensated inputs, 
triggers, range and offset controls, and embedded 
digital signal processing." 

The Micro was designed for the Raspberry Pi, 
and you can even “use BitScope Micro to monitor 
your project using the same Raspberry Pi," reveals 
Bruce. In fact, this is how BitScope tests each Micro 
during production. 

*BitScope Micro comes with everything you 
need to get started," Bruce confirms, but there 
are other bundles if you need a Hammerhead 
or Tom Thumb attachment. N DU S TR I 

A Pi with a display makes for a “convenient 
‘stand-alone mixed signal oscilloscope’ at a much ы 
lower cost,” Bruce suggests, while using Pimoroni’s G p Go 
Explorer HAT (£18, magpi.cc/10AKy46) allows you O Ї 
to read all the signals that a Pi generates. As Bruce 20+ new projects for you r Pi robot car. 
explains, “Without a BitScope Micro, you’re more - 
or less ‘flying blind’ when it comes to seeing and 
understanding what’s actually going on.” 

The BitScope Micro is available now for $145 (£108), 
or for $98 (£73) each for orders of ten or more - 
see magpi.cc/2kt7wr9. 


This tiny device 
houses a whole lot 
of signal analysis 
hardware 


BrickPi3 


LEGO MINDSTORMS + RASPBERRY PI 


www.dexterindustries.com 


raspberrypi.org/magpi January 2018 MägPi | 13 


pi-top 


Inspiring inventors and creators to (Sj RASPBERRY ы 
seek the skills of tomorrow and | 
create their future, today. OCR 


pi-top 
Colors ШЕН 
Raspberry Pi 3 optional 


AWESOME INVENTOR’S KIT INCLUDED 
20 + projects 
to explore 


Explore beyond the screen and keyboard by 
creating with the all-new pi-top modular laptop. 


The modular laptop with sliding keyboard 


[| : я : Я n 
e © fad Get started with 20+ inventions in the inventor's 
sry сотый MODULAR guide booklet. There are 3 inventor's journeys - 
5 RAIL Smart Robot, Music Maker and Space Race. 


8HR BATTERY 
LIFE 


HINGE 


pi-topCEED 


Colors M 
Raspberry Pi 3 optional 


pi-topCEED is the plug & play modular 
desktop. It's the easiest way to use your 
Raspberry Pi. We've put what you love 
about our flagship laptop in a slimmer 


form factor. Join hundreds of code clubs 
The modular desktop 


te 


14" FULL HD MODULAR 
1080P SCREEN RAIL 


and classrooms using pi-topCEED as 
their solution to Computer Science and 
STEAM-based learning. 


Modular 
Accessories 


pi-topPROTO pi-topSPEAKEI pi-topPl 


Ө www.pi-top.com © @GetPiTop Ө /GetPiTop Stay up to date with our latest news by following our social media 


КШТ 


pi-top is an award-winning ecosystem designed to make 
experimenting, cading and building electronics, simple, 
affordable and fun. pi-topOS is here to guide you through 
the world of making! 


The OCR* endorsed pi-topOS (Operating system) platform 
comes pre-installed on the SD card shipped with every 
unit. pi-topOS software suite lets you - browse the web, - 
check emails, - create and edit Microsoft Office 
compatible files. Gain access to dozens of hands-on 


learning lesson plans with pi-topCODER and have fun 
learning to code with CEEDuniverse! 


CEEDuniverse 


474. 


pi-topCODER has а fully 
integrated coding environment 
letting you program hardware 
code in Python and learn lots 
of STEAM skills! Our integrated 
test framework gives you the 
ability to assess your own 
understanding as you Learn 


CEEDuniverse 


Learn programming concepts 
through our minigames, 

for example, learn problem 
decomposition by solving 
visual programming puzzles. 


ne of the most common 

questions we see online is 

Гуе just got a Raspberry 
Pi, what should I do with it? 

We've all been there: getting 

into the latest coolest thing and 
not being sure where to start. 
Remember asking your friends 
what games to get on your first 
smartphone? If you didn't already 
keep up with what was hot, you 
had no idea, and that's the same 
when you join a new community. 


In this article we'll show you how 
to get started with your Raspberry 
Pi hardware, as well as how to join 
the global Raspberry Pi community 
and become a maker. 

Welcome to the world of 
Raspberry Pi. 
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Get to know your new Raspberry Pi computer and the community 


ARM: The type of processor the 
Raspberry Pi uses. It's typically 
used in small devices such 

as smartphones 


GPIO: General-purpose input/ 
output, these are the pins that 
line the side of a Raspberry Pi and 
allow you to connect electronic 
components to it 
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What actually is the Raspberry Pi? 


Processor: 1.2GHz quad-core 
ARM processor 


Memory: 1GB 
Networking: Ethernet, wireless 


Connectivity: HDMI out, 
analogue audio/video out 

(3.5 mm headphone hack), 
Bluetooth 4.1, 4x USB 2.0 in, 
micro USB power, 40-pin GPIO, 
Camera Module port (CSI), 
Display Module port (DSI), 
microSD card slot 


Dimensions: 86 x 56 x 17 mm 


Processor: 1GHz single-core 
ARM processor 


Memory: 512MB 
Networking: Wireless 


Connectivity: Mini HDMI out, 
Bluetooth 4.1, micro USB in, 
micro USB power, 40-pin GPIO, 
Camera Module port (CSI), 
microSD card slot 


Dimensions: 65 x 30 x 5mm 


» 
* 


1С: 20953-RPI32 


Weight: 459 


FCC 10: 2АВСВ-8Р132 


Weight: 9g 


0000000000 
0000000000 


Тир ач haina 


бесте 


ШП: ico 


WHAT CAN YOUR RASPBERRY PI DO? 


The Raspberry Pi is a full computer. It 
has a processor, graphics processor, and 
memory, just like anormal computer or 
laptop - it’s just a lot smaller. 

The Raspberry Pi can be used in any 
situation a computer could be used. This 
can be as simple as being used as your 
desktop computer, or plugged into a 


special laptop shell. Other people use 
them as mini servers in their house, as 
media computers for their TV, or as tiny 
computers to power their fun projects. It 
could be the brains of a robot, control a 
vegetable garden, or even just blink a light. 

The possibilities with Raspberry Pi are 
limited only by your imagination. 
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SET UP n fy ESSENTIAL. 


YOUR RASPBERRY PI 


First time using a Raspberry Pi? 
Here's how to get it ready Y © 


MICRO SD CARD 


SET UP YOUR MICROSD CARD 


The first thing you need to do is make sure your 

коюу . , microSD card has an operating system on it so that 
the Raspberry Pi can run. For newcomers, NOOBS is 
the recommended way of installing Raspbian, the 
=o =o. Raspberry Pi operating system. Download it from 
magpi.cc/2bnf5XF and then unzip the files directly 
onto a freshly formatted microSD card. 


MONITOR 


KEYBOARD 


cisco E 

HOOK IT UP Na: XJ | к= 
G > UD ee — 

T ы 1 | Г > 

Like any computer, you need to make sure HEATH D => 
everything is plugged in properly. Connect the ot ч ew h^ 


monitor with the HDMI cable to the HDMI port on HON E uli 
the Pi, firmly push the microSD card into the slot | ЕЧ nun 


under the board, plug in your mouse and keyboard, 
and then finally insert the power so it turns on. 


ZI 


HDMI CABLE 


go 9 ө, INSTALL RASPBIAN 


*. i 


NOOBS will give you the option to use one of many 
operating systems on your Raspberry Pi. Select 
*Raspbian with Raspberry Pi Desktop’ and it will boot 
into it. From here you can set up your wireless internet 
and any user preferences. It's also a good idea to update 
the files by opening the Terminal (via the little black 
box in the top bar) and typing the command: 


POWER SUPPLY (2.5 A) 


sudo apt-get install update 


...and then press RETURN, followed by the command: N 


sudo apt-get install upgrade 


CASE 
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Free resources from the 
Raspberry Pi Foundation 
to help you on your way 


hen most people think about the Raspberry 

Pi, they think of the computer. What a lot 

of people don’t know is that the Raspberry 
Pi Foundation is a charity that also provides free 
resources for people wanting to learn about computing 
and making. This doesn’t just apply to making stuff 
with the Raspberry Pi either. 


The Raspberry Pi Foundation has a rich history 

of providing free resources for both makers and 
teachers alike, including offering free teacher 
training courses with Picademy (magpi.cc/2Bakf96). 
These range from simple programming lessons to 
full-on physical projects you can build in your own 
home. Here are some of our favourites. 


SCRATCH OLYMPICS 
WEIGHTLIFTER 

# magpi.cc/2B9fOf1 

There are plenty of Raspberry Pi resources that make 
use of Scratch, a beginner's programming language 
that makes use of blocks to create code. This 
weightlifter game uses fun retro sprites and a classic 
game mechanic that you learn to make yourself. You 
can then challenge your friends on it! 


BIG MINECRAFT PIANO 

zs magpi.cc/2B9KGvY 

There's a special version of Minecraft on Raspberry Pi 
that you can modify by programming in Python. This 
particular project shows you how to recreate the big 
piano from the movie Big in Minecraft, allowing Steve 
to jump around and make his own music. 
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Code Club is a network of after-school and 
extracurricular computing clubs that provides free 
resources for kids aged 9-13 to learn how to code using 
Scratch and Python. There are thousands of clubs 
around the globe, so check to see if there’s one in your 
local area. You can even start a Code Club if you want, 
and there’s more info for that on the site. Here are 
some of our favourite projects. 


# codeclub.org.uk 


THE MAGPI 
RESOURCES 


Oh hey, that’s us! We’re the official Raspberry Pi 
magazine, made for the community. Not only is this 
our 65th excellent issue, we also have a selection of 
pocket books on single subjects in our Essentials 
range, as well as our yearly Project Books. If you 
can’t afford or find older issues, every issue of 

The MagPi is available as a free PDF online from our 
website. Here are some of our favourite releases 

for beginners - so far! 


magpi.cc/2bA3ZP7 
Want to learn how to program 
physical objects on your Pi? 
The GPIO Zero library for 
programming language Python 
makes this very easy, and this 
book takes you from the basics all 
the way to controlling a robot with it. 
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TURTLE RACE 

# magpi.cc/2kLBki6 

This simple Python game has you racing four turtles 
against each other. The outcome is random each 
time, so you'll be cheering for your chosen turtle 
throughout the entire race. This project also teaches 
some animation tricks with simple graphics. 


magpi.cc/2dcswel 
Want to be inspired by all the amazing stuff people 
have made in the community? We count down the 50 
best projects as voted for by the community. We could 
easily do 50 more amazing projects as well - there are 
so many talented people in the community! 


magpi.cc/2AqrV6q 
Our previous issue! Here we show you how to read 
electronic circuits, and how to construct them so 
you can make your own amazing projects. Raspberry 
Pi makes it relatively easy, but you still need a 
stepping-off point. 


magpi.cc/2Aige2w 
Our Projects Books are crammed full of projects and 
guides that will both inspire you and help you make 
some incredible things. Our latest version has 200 
pages of Pi articles and the cover is very swanky, if we 
do say so ourselves. 


ус — X— — БУ ___ 
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The Raspberry Pi community is 
huge and welcoming to everyone 


e’ve talked about how the Raspberry Pi is 

both a computer and a charity, but it’s also 

a huge community of like-minded makers 
and coders. Don’t be intimidated, though! The 
community is very welcome to newcomers, as the 
Raspberry Pi is all about getting people excited to 
use computers. Here’s how you can dip your toes 
into the community at large. 


t$ raspberrypi.org/forums 


The official Raspberry Pi forums are a thing of 
wonder. Hundreds of people come together to 
help people with their projects and problems 
- from simple things to incredibly advanced 
Linux tweaking. If you ever have an issue with 
the Raspberry Pi or Raspbian, head to the forums 
and use the search function to see if anyone else 
has ever had a similar problem and if not, start a 
new thread. 
There are sub-forums dedicated to many specific 
parts of Raspberry Pi, from beginner's guides and 
troubleshooting to education chat and info on 
programming in specific languages. 


Ба < 


нар 
Press [F11 | to ext full screen 
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Some Raspberry Pi help and discussion can be 
found outside the official community forums, 
sometimes dedicated to more specific software 
or hardware. Here are some good places to take 
a look for more Raspberry Pi. 


RASPBERRY PI 
SUBREDDIT 
$¥ magpi.cc/2AhIO42 
The Raspberry Pi 
subreddit is a great 
place to see some of 
the coolest projects 
from the community 
get highlighted, as well as get news from the 
community itself about products and updates! 
They'll even answer some Pi-related queries, 
although you should check out the official forums 
for that first. 

It's also a great place to show off your project and 
get feedback for it from the community at large – 
it's always fun to have a little following, after all! 


KODI FORUMS 

t$ forum.kodi.tv 

Equally as popular 

as retro gaming, the 

Pi is great as a media 

PC hooked up to your 

living room TV and 

most home-theatre PC 

software solutions will use Kodi for this. While you 
may be better off Looking at the documentation for 
your particular software, if that doesn't help then 
you can always check out the Kodi forum. It's a big 
and busy forum, though, so remember to 

make good use of the search function! 
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ODE HELPER 


great social media 
accounts that you 
It’s probably no surprise to hear that there are should follow 
alot of people in the world who code. Whether stackoverflow.com 
they're professional coders for big companies This website is one of the best places to ask about 
or teens playing with Python, they all have one coding problems as not only is it incredibly popular, 
thing in common: sometimes they might need a rewards are given to people who help out with 
little bit of help. There are a couple of great places an answer. We've seen people ask questions on a 
to head to when you find yourself up against a huge number of topics at varying skill levels, such 
proverbial brick wall. as how to correctly call an item from a Python list 
or use complex database commands for a website. The official Raspberry 
There's also a robust search feature included, and Pi Twitter account 
Google will generally point you towards pages 
on Stack Overflow if you've looked there for 
answers first. Our official 
Twitter account 
google.com Learn, Share, Build Maker of fun Pi 


We're not being patronising here - a good Google 
search will genuinely help you out with many code 
issues. There's nothing new under the sun as they say, 
and there's usually someone who has had the exact 
same issue as you, or you might trip over the wording 
for what you want to do in a very helpful bit of official 
documentation. Always give any issue a quick Google 


and you may be surprised at how easy you can find an | - Hn 


answer, and how simple the solution may be. 
FACEBOOK 


The official Raspberry 
Pi Facebook account 


projects and add-ons 


Raspberry 
Pi-powered 
racing robots 


Our official 
Facebook page 


Raspberry Pi Spy is a 
great way to keep up 
on Pi news and see 
awesome tutorials 


The official Code 
Club UK Facebook 
account, keeping 
you up-to-date on 
all the cool things 
they do 
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PROJECTS 


Want to be inspired? Here are some amazing projects 
that we’ve seen from the community 


very day we Keep an eye on Twitter and 
Reddit to see what amazing stuff people are magpi.cc/2vN4rEo 
coming up with to do with their Raspberry More retro upcycling with this old-school phone 
Pis. Here’s just a taster of what we see online and upgraded with an AIY Voice Kit. Just dial o and you 
what you can see in the magazine. can talk to the assistant to get answers to your 
everyday queries. We have visions of someone 
just picking it up and putting it under their chin to 


ask for ounce-to-gram conversions while they mix 
some batter, Nineties style. 


9 Arden Albert 


Got our retro home assistant running with 
and . Now 


magpi.cc/2vPQK6E we can dial '0' for the operator (Google)! 


An amazing project that uses the AIY Projects Voice 

Kit from issue 57 to hack an old-school intercom to 
become a digital voice assistant. It's an ingenious bit of 
repurposing, and we always love seeing what Martin 
Mander is going to upcycle next. For some reason, 
though, everyone else has been having the same idea 
and we saw loads of toy phones and intercoms and 
other voice-powered products upgraded with an AIY 
Voice Kit. Here are a couple of our favourites... 


magpi.cc/2vMuSty 
This one is a little mean but honestly, we laughed. 


The Fisher-Price 

toy phone is a true @ 

classic and we love ИИА 
the idea of it getting Ё Bek end ya ын дет 
avery hefty upgrade 

with AIY, complete 

with massive glowing 

button in the centre. 

Would it be creepy if 

you had it sing while 

the eyes moved? 

Very probably. 
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CIRCUITBEARD 


( Folow ) 


Blogged: Tomy Turnin' Turbo Dashboard 
Outrun Arcade - The build log for my mini 
#outrun arcade 
circuitbeard.co.uk/2017/08/28/tom ... 
#raspberrypi 


magpi.cc/2xckwUo 
While we have seen many console or arcade 
hacks over the past few years, this inventive hack 
of one of those sports car dashboard kids toys 
wowed us when we saw it. It doesn't hurt that it's 
themed around Out Run, one of the best arcade 
series of all time. 


magpi.cc/2BjtDak 
Acustom Nerf-firing robo-tank that gives you only 
20 seconds to comply. We got a bit of a preview of 
this last month and we've been excited to see the 
final product. Follow the link to learn more and see 
it in action! 


ё David Pride 
Meet FRED-209. 


A powered, Nerf 
Tank! Details and video here: 
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magpi.cc/2yMfQrI 
The picture for this project 
doesn't really do it justice, so 
take a quick look at the video: 
magpi.cc/2yMgAgu. Needless to 
say, it's a very effective and scary 
project that uses a little illusion and a 
motion sensor to make you think the 
painting is moving. And attacking. 


magpi.cc/2yMcogZ 
This automated jack-in-the-box uses a camera to 
detect if someone is around. If you turn up in front 
of it, surprise! Pop goes the weasel and also about 
three years off your life. Put it in an inconspicuous 
part of your house to scare the bejeesus out of 
friends and children. 


magpi.cc/2yMflIse 
The theme has since been changed to Christmas 
holiday lights, but the original setup allowed you to 
control Halloween decorations on the Poplawkis' 
lawn. There's a camera recording the whole thing, 
and you can control various decorations - with the 
option to keep your selection active for one minute 
by spending a credit (costing 10 cents). 
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A Raspberry Jam сап be a lot of things, but 
usually it’s a social event people can attend to 
learn about the Raspberry Pi. Typically you'll see 
people showing off their projects, as well as stalls 
where you can buy Raspberry Pi add-ons and 
electronics kits. 
These Jams are hosted by community members; е0 


Meet Raspberry Pi users in real life in fact, anyone can host a Jam if they wish! 
and see talks by computing boffins Head over to the info page to find out more on 
that might help you Raspberry Jams, including an events calendar so 


you can try to attend one! 


rpf.io/jam 
he Raspberry Pi community online is so big 


that it regularly leaks into the real world, 

usually through the power of a Raspberry The Raspberry 
Jam. However, the Pi makes itself into many other Pi birthday 
events that involve technology, such as Maker Faires. 


CODER 


CoderDojo is part of the Raspberry Pi Foundation 

and, much like Code Club, provides free resources 

for people wanting to create programming clubs for 

kids. There are also CoderDojo events such as the 

Coolest Projects showcase, allowing young people to The yearly robot 
show off the awesome stuff they’ve been making. challenge Pi Wars 
spun off from the 
popular CamJam 


weekend-long 
Raspberry Jams! 


coderdojo.com 


Pi-monitored bees make 
them a bit safer to keep 


Be sure to check out the 
#raspberryjam hashtag 

on Twitter to see what 
awesome things people 
are showing off 


| You can find robots galore at 
the Coolest Projects showcase 


RASPBERRY $ 
ө JAN 2 

Get all the info you need to GUIDEBOOK 
set up your own Raspberry 
Jam: magpi.cc/2q9DHfQ 


Glowing ping-pong balls are 
a favourite for LED projects 
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Want to buy more Pi goodies? Take a look at these places... 


shop.pimoroni.com 
Purveyor of Raspberry Pi goods and 
general maker ware, Pimoroni is 
one of our favourite places for fun 
and beginner-level projects, while 
also offering plenty of components 
for almost any project you can think 
of making. 


thepihut.com 
The Pi Hut sells a lot of Pi add-ons 
and gear, along with robot parts 
from the excellent PiBorg, as well 
as a host of simple kits like the cute 
3D Xmas Tree. It also has a robust 
maker store with plenty of extra 
parts you’ll need for many projects. 


raspberrypi.org/magpi 


adafruit.com 
Adafruit not only creates incredible 
electronics for makers, but also 
posts amazing tutorials that make 
use of some of its electronics. 
There’s plenty of Pi-compatible 
stuff and it’s perfect for getting Pi 
paraphernalia if you live in the US. 


modmypi.com 
While it does carry a lot of 
Raspberry Pi-specific hardware 
and add-ons, we love how much 
maker gear you can also get at 
ModMyPi, including obscure 
components you might have 
trouble finding elsewhere. 


pi-supply.com 
A great online store for everything 
Raspberry Pi, Pi Supply usually has 
some very interesting Pi add-ons, 
and they accompany projects as 
well, including the Flick 3D gesture 
boards and the PiJuice mobile 
power HAT. 
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| SUBSCRIBE TODAY AND RECEIVE А 


Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 
Free Pi Zero W case with three covers 


Free Camera Module connector 
Free USB and HDMI converter cables 


Other benefits: 
Save up to 25% on the price 
Free delivery to your door 
Exclusive Pi offers and discounts 
Get every issue first (before stores) 


YOUR OFFICIAL RASPBERRY PI MAGAZINE 
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Mag#65 


Ms 
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£30 к 
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PAYMENT OPTIONS 
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Instruction to your bank or building society to pay by Direct Debit 
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£12.99 (Uk) (Direct Debit) f... BEER 
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4 Available on the 


RETURN THIS FORM TO: 


€ A p p Sto re MagPi Magazine Subscriptions, Select Publisher Services Ltd, PO Box 6337, 


Bournemouth BH1 9EH 


Please tick this box if you DO NOT want to receive any other information 
from Select Publisher Services Ltd. 


GET IT ON Pleasetickthis boxifyou DO NOT want to receive any other information 


> G | P| from other companies. 
00g е ау Please tick this box if you DO NOT want to subscribe to The MagPi newsletter. 


raspberrypi.org/magpi January 2018 MägPi | 29 


MIDI data is slowed down 
by this buffer so the synth 
can pick it up 


Acheap USB audio 


card is used to connect 


the microphone 


The custom MIDI interface 
is used to send synth data 
to the TX7 


-APHEX TWIN 


Somewhere in Cornwall, there's a synthesizer that boinks endless 
strange sounds as they slowly evolve towards a new synth patch. 
Sean McManus investigates 


» Making a good 
patch manually 
can take days 


» Midimutant 
can make 
thousands 
of patches 
per day... 


> „But only about 
half of them 
are useful 


> Dave coded 
Midimutant 
in C++ 


> He now has 
3792 saved 
Midimutant 
DX7 patches 


f you're a fan of 80s pop, 

you'll have heard the 

Yamaha DX7. It’s one of 
the best-selling synthesizers, and 
its built-in sounds can transport 
you to the era of big hair and neon 
leggings. One reason it is evocative 
is that so many artists used those 
preset sounds, to the point of them 
becoming a cliché. The synth is 
based on frequency modulation 
(FM), and it could take a few days to 
create a good patch (or sound). Many 
chart-toppers took the easy way out. 

*Pm nuts about FM synthesis," 

says Richard James, who creates 
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electronic music as Aphex Twin. 
“The first proper synth I got was 

a DX100 and I've always thought 
there's got to be a more interesting 
way to program the damn things 
than laboriously going through 

all the hundreds of parameters. 
Even though I quite like doing that 
anyhow, hehe." 

A conversation with his friend 
Dave Griffiths led to Dave building 
Midimutant, a Raspberry Pi-based 
device that programs the synth 
for you. *This is something you 
want to leave running for hours," 
says Dave. “The Raspberry Pi is 


essential because you can make 
a stable setup that isn't going to 
start updating itself and reboot." 
The idea came from a lost 
feature on the Kyma synth, 
based on the work of Andrew 
Horner, which enables sounds to 
evolve. Midimutant uses a similar 
approach: you give it a sound, 
and it aims to recreate it on the 
Yamaha TX7, a version of the DX7 
without a keyboard. "There's 
nothing especially great about a 
TX7 apart from I love all forms of 
FM and that is a really small unit, 
so it's a lot easier to handle than 
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sound physics biology magic 


record target sound 


evolve! 


a DX7 or other FM devices Гуе got Midimutant sits on top of the 
lying about," says Richard. Yamaha TX7 synth. The Raspberry Pi 


Touch Display is used for control 
Dave adds: “The DX7 is the 


‘classic’ FM synth. If it works on it usually (although not always) 

that, it would work on anything.” converges on something good,” 
" says Dave. The most interesting 

Random scoring sounds emerge from trying to 

At the start, a population of random match beats and voices. 

sounds is created. Each one is One fascinating aspect of the 


compared to the source sound using project is that Midimutant doesn’t 
Mel-frequency cepstral coefficients need to understand how the 
(MFCC), a way of comparing sounds synth functions. It just needs to 
that comes from recent work on know how to format the (initially 
speech recognition. random) data so the synth can use 


The DX7 is the ‘classic’ FM 
synth. If it works on that, it 
would work on anything 


Each of the random sounds is it, and it uses the sound the synth 
scored and ranked for its similarity produces to score the results. 
to the source. The program gets The biggest challenge? 
rid of the lowest scoring half, “Listening to endless bonkers sound physics magic 
and creates a new population by sounds for days on end, changing 2: 
copying with errors (mutation) апа parameters slightly and waiting 
crossbreeding (mixing together) ages to see if there was an IT 
the top half. *Repeat this process improvement," says Dave. 
tens or hundreds of times and * Actually, that was quite fun..." 


randomise me 


evolve! 


m 


The Yamaha DX7 is an iconic synth, 
but Midimutant should work with 
other FM synths too 


Image credit: Flickr user deepsonic (CC BY 2.0) 
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Mambot's 


A Pi Camera Module is 
mounted on the arm to 
provide video streaming 


manipulator arm is a 
customised OWI-535 


> Mambot has 
seven degrees 
of freedom 


> The camera 
streams video 
to a local web 
address 


> Six AAA 
batteries 
power the 
motors 


> Mambot 
originally had 
a wagging tail 


> Shape and 
colour 
recognition 
are planned 


Ahmed first 
experimented with 
mounting the arm 
ona two-wheeled 
chassis, before 
opting to customise 
an OWI АЦ Terrain 
Robot kit 


All the software is run 
on a Raspberry Pi 3 
using multithreading 


Is there anything Ahmed Al-Faris's remarkably versatile robot can't do? 


e get to see a lot of Pi- 

powered robots, but rarely 

(if ever) one crammed with 
quite so many features as Mambot 
(youtu.be/AtQqE1M9Ff4). The 
creation of software developer 
Ahmed Al-Faris, it features a 
manipulator arm, five control 
methods (including autonomous), 
video streaming, Alexa voice 
interaction, obstacle avoidance 
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system, and the ability to read text. 


Not only that, it is even integrated 
with the eAccounting ERP system 
at Ahmed's employer, Visma 
Software International, enabling it 
to scan and handle orders. 

It has certainly come a long way 
since Ahmed's original aim: “At 
the beginning, I just wanted to 
turn two wheels using the Pi." He 
reveals that the Mambot hardware 
is constructed primarily from the 
OWI-535 robot arm and OWI All 
Terrain Robot kit. “Both have been 
disassembled, reconfigured, and 
customised heavily. Trying to fit 
everything together was tricky. A 
lot of hacks were involved using 
bits and pieces.” 


Ahmed has been working 
on Mambot for around a year, 
using the little free time he has. 
“There were many moments of 
desperation, where I wanted to 
abandon the whole build,” he 
admits. “Perseverance was the key 
to continue.” 


Pi programming 

Mambot’s software is written 
primarily in Python. “I used 
Python before now and then to 
automate tasks around the house,” 
says Ahmed, “but this is my first 
major Python project.” Other 
programming work included the 
creation of an Android app (in 
Java) which, as well as offering 
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remote control of the robot апа 
arm, acts as a hub for accessing all 
Mambot’s features. 

“I started by adding gamepad 
control first. Then I thought, 
why not write an app for ite, 
so I did. The voice control was 
particularly challenging. I use 
Snowboy hotword to issue 
voice commands. It works great 
in a quiet environment.” 

Everything is handled by a 
Raspberry Pi 3. *As I kept on 
adding features, I quickly realised 


controlling it from the gamepad at 
the same time." 


Following orders 

With the eAccounting integration, 
Mambot listens for incoming 
orders and when one is received, 
it matches it with the job that 
needs to be carried out. *Say the 
order is to pick up an item from 
a warehouse or perform a service 
like sweeping the floor. Mambot 
performs the order, updates, and 
reports back to the system." 


I started by adding gamepad 
control first. Then I thought, why 
not write an app for it?, so I did 


that running everything on a single 


Pi could be problematic. Enter 
multithreading." After running 
the main Bluetooth routine on 
the Pi to accept a connection from 
the Android app, and start video 
streaming and the web app server, 
you can easily switch on/off the 
features you want. “Each feature 
runs on its own thread. The Pi 
handles this nicely. For example, 
you can control Mambot from 

the app while someone else is 
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Mambot has another neat trick 
up its sleeve: using machine 
learning, it can predict when the 
next order will arrive. “Before the 
time comes, Mambot moves to the 
location where the predicted order 
is supposed to be carried out.” If 
it arrives, Mambot performs the 
task; if not, it learns from this 
to improve its predictions in the 
future. *The more orders you send 
to the system, the more accurate 
the prediction is.” 


Connected to tpg-bot01 


As well as offering full control of the robot, and a live 
video stream, the Android app enables you to turn Mambot's 


many features on and off 
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> Dmitry bought 
his first 
Raspberry Pi 
in 2013 


> He wrote 
programs that 
communicate 
with sensors 
on it 


> FruitNanny 
taught him 
3D modelling, 
soldering, 
and web 
development 


> Most parts 
were bought 
from Adafruit 
and Amazon 


> The system 
is based on 
Raspbian 


aby monitors have grown 

up fast. Once confined to 

audio, they now have all 
manner of gubbins inside them, 
from cameras and night vision to 
temperature readings, two-way 
talk, and even lullabies. For many 
parents, they’re an essential tool 
for ensuring a baby is comfortable 
and safe. But although there are 
so many on the market, none of 
them suited Dmitry Ivanov. So he 
grabbed a Raspberry Pi and made 
his own. 

Called FruitNanny, the invention 
essentially began with a camera- 
connected Pi stuffed inside a 
plastic lunchbox. “Ра ordered the 
Pi NoIR module and a microphone 
and started to experiment,” he 
tells us. “I played with different 
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The lights are divided into 
four groups of three infrared 
LEDs, a 27 О resistor anda 
ТІР120 transistor 


FruitNanny uses a Pi NoIR 
camera module. It also has 
a DHT22 sensor to detect 
temperature and humidity 


Dmitry has made the case 
model available, but he 
wishes it were bigger and had 
more ventilation holes 


NANNY 


Rather than throw a tantrum when he failed to find the perfect baby 
monitor for his newborn, Dmitry Ivanov decided to get creative 


programs and tools, but most of 
them didn’t work.” 

He found the original Pi wasn’t 
powerful enough for the job and 
switched to a Pi з. “I spent lots of 
sleepless nights trying to find the 
right combination,” he continues. 
“But when I finished a proof of 
concept with a working setup ina 
lunchbox, I started to think about a 
case and a proper web application 
to combine information from 
sensors and media streams.” 

As a bare minimum, Dmitry 
wanted his baby monitor to stream 
audio and video to his PC without 
latency. He also wanted it to show 
the current temperature and 
humidity, work at night, and have 
a quiet mode where it was possible 
to see the audio streams but not 


hear them. Sticking with the NoIR 
camera and a cheap iPhone lens to 
widen the viewing angle, he added 
a DHT22 sensor to gather the 
temperature and humidity data. He 
also used twelve infrared LEDs for 
night vision and added resistors. 


Custom case 

“I started to design the case too,” 
he says. “I had several cases for 
Raspberry Pi, but I couldn't fit all 
of the hardware inside. I wanted 
something that looked pretty and 
not boring like almost every other 
baby monitor." He considered 
making it in the shape of a toy 
like Ironman or a Minion. *But 

I soon realised that I don't have 

a designer's talent. I tried 3D 
modelling with SketchUp and a 
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2STEP-01 
A tight squeeze 


The Raspberry Pi 3 is placed within 

the specially printed case. The sensor, 
transistors, and LEDs are connected to 
the GPIO pins; the Camera Module to CSI; 
and microphone to USB. 


3D printer for the first time and 
after several failed attempts and 
with the help of a friend, Christos, 
printed a simple rectangle, which 
worked well.” 

The case is actually in four parts. 
The Pi and the electronics are fitted 
in the main part of the case and a 
cover is placed over the top. There is 
a cap for easy access to the Ethernet 


Since the FruitNanny has 
sensors and lights and makes 
use of WiFi, it uses a 2A 
power adapter 
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>STEP-02 


The case lid 


The case lid is fitted with twelve LEDs. 
The Camera Module - equipped 

with an iPhone lens - is placed in 

the centre hole. The lid is screwed 


to the case. 


port of the Pi and a DHT22 cradle 
which isolates the sensor from the 
Pi and protects it from heat. Fitting 
the electronics together proved 
relatively straightforward. The 
software was a little trickier. 

“T had used a UVAL video driver 
at the beginning because it was 
easy to install and configure,” 
he recalls. “But it’s a proprietary 


Fruitnanny 


Dashboard 


Temperature 


>STEP-03 

Accessing the stream 

FruitNanny uses a custom web UI and 
works with Windows, Linux, Android, and 
macOS. The dashboard allows the video 
feed to be viewed, along with the current 
temperature and humidity. 


product and it wasn’t easy to 
customise. I wanted to add my own 
video settings and extended web 
UI, so I decided to use something 
different. Since I needed a real- 
time media stream without 
latency, I found an amazing project 
from Meetecho, called the Janus 
WebRTC Gateway. I took this, 
added GStreamer and several 
scripts, and tied everything up 
with the Node.js web application.” 
The baby monitor worked a 
treat, providing an affordable and 
secure video baby monitor that 
Dmitry could potentially customise 
in the future. Yet he admits he 
only used it for a few months: 
*When my son turned one, we 
started to use it very rarely." Even 
so, he says his head is now full 
of new projects. “I’m also still 
going to work on the FruitNanny 
occasionally to help people in the 
same situation I was in.” 
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GIORGIO GILESTRO 


Dr Gilestro heads up a research 
laboratory at the Department of Life 
Sciences at Imperial College London. 
magpi.cc/2i3vTHt 


LIHOSCOPE 


Scientists have created mini robotic labs powered by Raspberry Pi 
to test the behaviour of flies - and learn more about humans 


They help 
Scientists 
gain insights 
into human 
illnesses 


The ethoscope 


records and 
classifies flies 
en masse 


It can monitor 
fly behaviour 
and study 
responses 


The Pi-based 
ethoscope 
can be built 
for £100 


he Raspberry Pi isn't quite 
capable of performing 
complex brain surgery (at 
least not yet), but that doesn't 
mean it can't help scientists work 
out how our minds are wired. So 
when a group of researchers looked 
for a low-cost way of conducting 
studies in neuroscience, they 
turned to our favourite computer. 
The result is a machine with 

the potential to make ground- 
breaking discoveries about 
common human behaviour. And its 
secret ingredient? A load of flies, 
of course. 


Behavioural arena 

Dr Giorgio Gilestro and his 
colleagues from Imperial College 
London have used the Raspberry 

Pi to create what they call an 
ethoscope: a device that can 

not only track animal behaviour 
using open-source hardware 

and software, but profile it using 
machine learning algorithms. They 
use fruit flies within their studies 
because they are similar to humans 
in genetic and behavioural terms: 
they can be used to study mental 
and physical human diseases 

and give insights into sleeping 

and socialising. 

But instead of manually 
watching the flies and scoring 
their movements, as has been 
the case in the past, the Pi-based 
ethoscope is able to process and 
analyse real-time video. In doing 
so, it allows scientists to automate 
such time-consuming processes. 
*We can also study hundreds or 
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Data is sent from the 
Pi to a PC over WiFi. 
The ethoscope is 
controlled by a web 
interface on a PC 


This head section holds a 
Raspberry Pi 3 and a Pi NoIR 


camera v2. A 32GB SD card 
contains the software 


The infrared light reflects upwards 
through the 'behavioural arena' where 
the flies are placed. It's powered by 
connecting the GPIO to the base 


maybe thousands of flies at once 
because [the ethoscopes] are so 
small and cheap to maintain," 
explains Giorgio. “Ву using the Pis, 
we have enough computer power to 
analyse their behaviour using video 


imaging and we can be wallet- 
friendly at the same time.” 

At first, the group used USB 
webcams connected to desktop 
computers running software that 
would analyse the behaviour of the 
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Ethoscope: 
“ETHOSCOPE_017” 


Here you can perform actions and know the status of the device 


© Started on Thu, 07 Apr 2016 10:24:46 GMT (i.e. ago) 


— 


>STEP-01 >STEP-02 >STEP-03 

Setting it up Monitoring automatically Wake up! 

A total of 20 flies are placed into the Software built on top of Linux and Python In the sleep study, the ethoscope 
20 3D-printed tubes that make up this makes use of the Pi NoIR camera апа will work out when a fly appears to 
particular behavioural arena. The unit begins to gather data. A web interface be sleeping. This added module can 
is then inserted into the bottom of controls the device and allows the flies flip the tube to wake it up and see 
the ethoscope. to be watched. what happens. 


flies being filmed. “This was very Right Dr Gilestro's laboratory has 80 
accessible because almost everyone Pi-powered ethoscopes set up within it 
has a computer and a webcam, but ttom Right As well as 3D-printing the 
it wasn’t very scalable or user- саза ро ооо the sthoscope 
friendly," Giorgio says. “There was 

also an issue of people running the Eight behavioural arena decks 
program on different computers have been created for research 
and hardware.” Using the Pis into areas such as feeding, sleep 
got around this problem and the patterns, and decision-making. 
scientists, led by PhD student It’s certainly proving to be 
Quentin Geissmann, eventually revolutionary (“it’s been very well 
came up with a scalable device. received in the community,” he 


| Research into areas such as 
feeding, sleep patterns, and 
decision-making 


After deciding to usea 3D-printed adds) and because the ethoscope 
modular design for the body of the is open source and the full 
ethoscope, they were able to placea instructions are online, it’s been 
Raspberry Pi on top, connected toa quick to take off. In actual fact, 
downward-facing camera. The idea there is already talk of future 
was to film a “behavioural arena’ at iterations. “It’s almost like a 
the bottom, filled with flies and lit commercialised product," Giorgio 
byan infrared LED. tells us. 
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Boot multiple Raspberry Pi devices at once using a PC/Mac 
computer running Debian with Raspberry Pi Desktop 


Raspberry Pi 3 
PC or Mac 


Debian with 
Raspberry Pi 
Desktop 


Raspbian 


| d 
T —— 


You can set up user accounts for 
each person on the network. It doesn't 
matter which Raspberry Pi they use, all 

their files are saved to the server 
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Normal users 


Attach several Raspberry Pi devices to 
the network and they can all boot from the 
main desktop Mac or PC computer running 
PiServer. None of the Raspberry Pi boards 
needs a microSD card (after the first setup) 


You can run different Raspberry Pi 
operating systems vi 


Your Raspbian system has been upgraded to the latest version. 


To ensure compatibility with the new version, some configuration files have been overwritten - 
if you had customised your system, some of your changes may have been lost 


Your original configuration files have been backed up and put in the directory ~/oldconffiles 


€ 


GNU nano 2.7.4 File: /boot/config. txt Modified 


Installing software 


Please wait while the software 


Add software 


Installation 


Finished 
51.2 MB of 1265.4 MB 
36.4 Mbit/sec 
4 minutes left 
nd ә 
introduc 


Finished 


Add clients 


Installation was successful, 


Add users 


Introduction 


You can now start using the system, and add additional users and clients as needed. 


Introduction Add software 


Add clients 
Installation 

PiServer enables you to set this computer up as a central server from which 

Add users multiple Raspberry Pis can be remotely booted Finished 


Add 


Requirements 
Installation 
ed Only Raspberry Pi 3s can be used. They must 
-have network boot enabled. 
be connected via Ethemet to the same network as this ser 
se the same keyboard layout as this server. 


Finis 


This server mus! 


have Internet access to d 


load required software. 
Process 


This wizard will guide you through the following process: 


1) Registering Raspberry Pis with the server. 
2) Creating user accounts 
3) Installing an operating system 


Tutorial 


> Raspberry Pi 3 


> Adisplay at 
least 1260 
pixels wide 


1 2 3 4 5 6 7 8 
This is the current playing 
order of the bells 


Click to swap two 


bells in the sequence 


mm 


4—T—7—1—1—71—7 71 0—7. 
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4—4 es а; 


md sient ip mie ON 
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Ring in the New Year with your very own tower of bells 


nce, when writing a Raspberry Pi book, your 

author used a section heading of ‘Ringing 

the changes’, to signify that the section was 
going to look at variations on what went before. He 
was astonished when his American editor had no 
idea what that term meant. In fact, the question 
‘what is the term for a bell ringer? , if asked on the 
popular TV quiz QI, would provoke the klaxon if you 
gave the answer ‘campanologist’, as that is what 
the study of bells is called. The correct answer would 
be ‘bell ringer’. 

Bell ringing has a lot more to do with mathematics 

than you might first think and, despite its ancient 
origin, it is an ideal topic to computerise. 


<---- Sequence ----> 


A 


—4—4—4—4— 4 *8—8/ 4. 3—3—3— 
qu TUE 4—4—4 2 ١ 
—1 1-3: 3 1 23 3 لو‎ 


E] (= Swaps] a 
981531427 6 


E 


—5—5” 7 е one 4 ==: 
жо —в—в6—6^7 7 7 7 Аа 
3—3—3—3 

2 3 


4444 —4—4—4 


quemque qmd m d m m dm d md m d mq аа, 


Ways of ringing 

While there are many different methods of ringing 

a set of bells, the two basic ones are change ringing 
and method ringing. In short, all the bells are rung in 
turn; this is known as a round. With change ringing, 
two of the bells in a round swap places for the next 
round. These bells must be adjacent in the current 
sequence, because of the very high mass of the bells 
which results in a limited ability to delay or advance 
the ringing position in a sequence. Method ringing is 
similar, but more than one pair of bells can change 
between any one round. In both systems they start 
and end with a round going from the highest bell, 
called the Treble, to the lowest, the Tenor. The bells 


This chart tracks the 
bells’ changes and 


sequences as you play 


5—6—6 
пав ——| 
357—712 —3 22 

3—3—3—3— 6 ES 
-= а н Е zs 3 
—4—4—4—4—4—4—4—4—4—4—4/ S —5—5 


qe gegen qm m] im em gg mn gm om 


—8 


are numbered, starting with 1 for the Treble. Note that 
this is the reverse of many systems in music, where 
the lowest number is reserved for the lowest note. 

Normally, there are anything between four and 
twelve bells, with eight being popular. If tuned, 
they are usually in the key of C. There are many 
hundreds of different methods, but the basic rule 
is that the round starts with the sequence 1 to the 
highest bell number and ends on that sequence as 
well, but no other sequence is permitted to repeat. 
Ideally, all possible sequences must be used; this is 
called an ‘extent’. But, for twelve bells there will be 
12! (12x11x10x9x8x7x6x5x4x3x2x1) combinations, 
and that would take over 35 years to ring. The record 
currently stands at 21 216 changes on the twelve bells 
of South Petherton Church, near Yeovil, which took 
14 hours 26 minutes to complete. 

It might come as a surprise, but the dedicated bell 
ringer is not interested so much in how it sounds, but 
in learning how to ring a specific pattern. In fact, a 
lot of the sequences are musically unremarkable and 
sound a bit like random ringing, even to the trained 
ear. The real appeal is in the physicality and discipline 
in getting it right. However, our curiosity got the 
better of us and we wanted to hear what it sounded 
like, so we wrote this simulator/player. It simulates 
change ringing, in that you can direct which bells to 
swap, but it will also play preprogrammed sequences 
where “опе man and his mouse' would be hard put to 
keep up any live determination of sequences. These 
sequences delight in names like Plain Bob Major, 
Bristol S Maximus, and Grandsire Cinques, to name 
but three. 


Documenting a ring 

These rings are documented by writing each 
successive sequence of bells, with lines connecting 
the bell numbers so you can see how they change. 
However, normally there is only one line for one bell 
to follow, and not all bells are numbered, as shown in 
Figure 1. This is understandable, because it is meant 
for one bell/player, and they just need to know if they 
have to keep their ringing position the same, or move 
up or down in the sequence. This shorthand, however, 
often makes it difficult for a beginner to follow. The 
full diagrams are normally shown as a vertical list; 

a full list, resembling braid, is shown in Figure 2. 
Alternatively, these lists of sequences can be shown 
horizontally, known as a roller, Figure 3 (overleaf), or 
even circularly as a ring, Figure 4. АП these pictures 
were generated by the free-to-use toolkit to be found 
at magpi.cc/2jCpOlt and reproduced here by kind 
permission of the author Steve Scanlon. 
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Figure 1 Normally there 
is only one line for one 
bell to follow, and not all 
bells are numbered 
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Figure 2 A full 
ringing diagram 
resembles an 
intricate braid 


January 2018 MägPi 


Tutorial ЛШ 


моми 
VUELOS ELS 


Figure 3 Sequences can be shown horizontally, known as a roller 


Preparing the resources 

The first thing we did was to prepare the graphics. 
We found a royalty-free image of a bell on the 
internet and rotated it through 90° in eleven stages. 
At each stage, we used a photo editing package to 
move the bell’s clapper; the results are shown in 


We want the bell to swing about 
the pivot point at the top, in order 
for it to look like a realistic swing 


Figure 5. The thing to note here is that we want the 
bell to swing about the pivot point at the top, in order 
for it to look like a realistic swing. So we have to plot 
each bell, in the animation, at a different position in 
the x direction, so that the pivot point ends up in the 
same spot. These images were named bo.png to 
b10.png and put in a folder called swing. The 


Figure 4 Sequences can 
also be shown as a ring 
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software would then scale this set of images so that 

each bell had its own sized animation sequence. 
Then the sound of eight bells were put in a folder 

called sounds and named 0.wav to 7.wav. We started 

with bells recorded from a MIDI sound generator, but 

eventually replaced these with live recordings, done 

by a friend, of the bells in St Matthias Church, Leeds. 
Finally, we prepared some method files based 

on classic methods. These are simple text files 

and consist of the sequence of each round, with 

a row of ‘~’ signs being used as a comment or 

blank line to break things up and make it easer to 

see what is going on. The two methods we have 

encoded like this are ‘Plain Bob Minor’ and ‘New 

Year Delight Minor’ and can be found along with 

the software in the GitHub repository. 


The software 

The program, bells_play.py, uses the Pygame 
framework. Most of the parameters - like colour, 
speed, and the control variables - are defined at the 
start of the code, just before the main function. The 
loadResources function does the scaling of each 
animation sequence and, as this takes some time, 
when each bell has been processed it is displayed 
on the screen, to prevent having a long time where 
nothing seems to happen. It is important to the 
visual effect that the bell goes through an animated 
sequence and doesn’t just flip from a bell on one 
side to a bell on the other, even though each 

image spends very little time on the screen. The 
handleMouse function sees if any of the ‘swap icons’ 
has been clicked and the checkForEvent function 
is where most of the other control takes place in 
response to keyboard presses. The drawSequence 
function displays the current order of the bells, and 
the showRing function points to the bell currently 
being rung. 


Using the software 

The software starts up in the stopped mode, 
pressing the R key will start it ringing, with the 

S key stopping the ringing at the end of the current 
round. It can use four to eight bells, selected by 
simply pressing the number keys on the keyboard. 
The + and - keys control the speed of the ringing 
and the F file key brings up a dialogue box to allow 
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RING THE CHANGES 


| Ü p y >PYTHON 3 
. import pygame, time, os, copy, random 
a from tkinter import filedialog DOWNLOAD: 
003. from tkinter import * magpi.cc/1NqJjmV 
004. 


005. pygame.init() # initialise graphics PROJECT 
interface VIDEOS 

006. pygame.mixer.quit() - 

007. pygame.mixer.init(frequency-22050, Check out MK 
МЕЧ h 15=2, buffer=512) Bakery videos at: 
size=-16, channels=2, bu EE magpi.cc/1NqJnTz 

008. 

009. os.environ['SDL VIDEO WINDOW POS'] - 


center 
010. pygame.display.set caption("Bells - Ring the changes") 
011. pygame.event.set allowed(None) 


012. pygame.event.set allowed([pygame.KEYDOWN, pygame . QUIT, 

013. pygame . MOUSEBUTTONDOWN] ) 

014. screenWidth = 1260 ; screenHight = 482 

015. screen = pygame.display.set_mode([screenWidth, screenHight], 0,32) 
016. textHeight=26 ; hangY = 30 

017. font = pygame.font.Font(None, textHeight) 

018. swingSpeed = 0.01 # animation rate 


019. bellX = [60,180, 320,460,620, 790,973,1160] 

020. backCol = (0,255,255) # background colour 

021. trails = [(255,0,0),(255,255,0),(0,255,0),(0,0,255), 

922. (0,0,0),(255,128,0), (255,255,255), (32,120,0)] 
023. speed - 0.4 ; running - False ; automatic - False 

024. random.seed() ; ringLength = 8 ; filePlay = False 


025. 

Figure 5 An array of frames of the bells in motion 026. def main(): 
027. global lastSequence, swapFrom, running, bellSequence 
028. drawLables() 

you to load in a specific ring. The A key will turn on 029. resetSequence() 

and off the automatic swap mode; this is where the 030. loadResources() 

swap position is generated at random. When the 031. print("Ring in the new - press R to ring") 

bells are running, clicking on one of the Swap boxes 032. print(is to stop - F to play a file - C to ring the changes") 

between two bells will swap then at the end of that 033. while True: 

round. All the time, the map or documentation of e NS аш 

s ре : 035. if filePlay : 

the sequence history is displayed scrolling along ane 2 PUDENES 

the bottom of the window. We liked to turn on the 037. drawControls() 

automatic swap mode for a time, then turn it off 038. lastsequence = fSeq[0] 

and manually swap bells to get the sequence back 039. i=-1 

to the start. 040. while i « int(len(fSeq))-1 and running: 
041. i += 1 

Taking it further 042. if int(len(fSeq[i])) > © : 

For a start, the bell sounds are all mono - it would 043. if int(fSeq[i] !-0): 

be interesting to space these out in a stereo field. 044. bellSequence = fSeq[i] 

Also, we have not implemented the ‘calling’ of the Pom pude 

bells; that is, calling out the two that need swapping 3 газел!) 

1 d with change ringing. Calling is done in ai лү, 

паго Д 8 8 ng. 8 : deepcopy (bellSequence[:]) 

two ways: calling up and calling down. The latter is 048. running = False 

the simplest, a call of ‘Six to Seven’ will swap bell 049. else: 

numbers six and seven; the only complication is that 050. if running: 

the highest and lowest bells are called ‘Treble’ and 051. playPeal() 

‘Tenor’. Such a list could be taken to any tower and 052. lastSequence = copy.deepcopy(bellSequence[:]) 

called. Finally, we urge you to have a good look at 053. if swapFrom != -1: # if we need to swap 

the toolkit from Steve’s website. If that piques your 054. bellSequence[swapFrom], bel1Sequence[ swapFrom+1 ]=b 

interest, why not see if there is a bell ringing group =шез апааа RED Ber Tse quence Hane com] 
655. swapFrom = -1 # remove swap call 


in your area and try the real thing? 


raspberrypi.org/magpi January 2018 Марі 


Tutorial TIAN ME 


056. 
057. 
058. 
059. 
060. 
061. 
062. 
063. 
064. 


065. 
066. 
067. 
068. 
069. 
070. 
071. 
072. 
073. 
074. 
075. 
076. 


077. 


078. 
079. 
080. 
081. 
082. 


083. 
084. 
085. 
086. 
087. 
088. 
089. 
090. 
091. 
092. 
093. 
094. 
095. 
096. 
097. 
098. 
099. 
100. 
101. 
102. 
103. 
104. 


105. 
106. 
107. 
108. 
109. 


110. 
111. 
112. 


drawControls() 
drawSequence() 


def playPeal(): 
global swapFrom, speed 
for ring in range(0,ringLength): 
showRing(ring) 
swing(bellSequence[ring]) 
if ring --2 and automatic and not(filePlay): # 
random swap 
swapFrom = random.randint(0,ringLength-2) 
drawControls() 
pygame.display.update() 
checkForEvent() 
time.sleep(speed) 


def setMode(mode): 
global filePlay 
filePlay = mode 


if filePlay: 
root - Tk() 
root.filename - filedialog. 
askopenfilename(initialdir = "/home/pi", 


title - "Select bell method",filetypes - 
(tkt files EXE), 
(zall fires" "E d 
loadFile(root.filename) 
root.withdraw() 
else : 
pygame.display.set caption("Bells - Ring the 
changes") 
resetSequence() 


def loadFile(fileName): 
global fSeq, ringLength 
nameF = open(fileName, "r" ) 
pygame.display.set caption( Playing - '"+fileName) 
sequenceFile - nameF.readlines() 
ringLength = int(len(sequenceFile[0]) / 2) 
fSeq = [] ; k=-1 
for i in sequenceFile: 
k +=1 
ns = [] 
for j in range(0,int(len(sequenceFile[k])),2): 
if i[j:j*1] != '-' and i[j:js1] != '\n': 
n = int(i[j:j+1])-1 # to get bells ð to 7 
ns.append(n) 
fSeq.append(ns) 
fSeq.append(ns) # extra line at end 
nameF.close() 


def showRing(n): # indicate the current ring point 
pygame. draw. rect (screen, backC 

ol, (524,248,185,16),0) 
drawWords("*",530+n*24, 248, (0,0,0) , backCol) 
pygame.display.update() 


def drawControls(): # draw swap radio buttons 
pygame.draw.rect(screen,backCol, (0,160, screenWid 
th,20),0) 
if filePlay: 
return 
for n in range(0,ringLength-1): 
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113. 
114. 


115. 


116. 
117. 


118. 


119. 
120. 
121. 


122. 
123. 
124. 
125. 
126. 
127. 
128. 
129. 
130. 


131; 


132. 


133. 
134. 


135. 


136. 
137. 
138. 
139. 
140. 
141. 


142. 
143. 


144. 
145. 


146. 
147. 
148. 
149. 
150. 
151. 
152. 
153. 
154. 
155. 


156. 
157. 
158. 
159. 


if n -- swapFrom: 
pygame.draw.rect(screen, (128,32,32) , (bel1X[ 
n]410,160,bellX[n*1]-bellX[n]-20,29),0) 
drawWords("«-- Swap -->",bel1X[n]+10 
4n*6,160, (0,0,0), (128,32,32)) 
else: 
drawWords("«-- Swap -->",bel1X[n]+10+n*6,16 
0, (9,0,0) ,backCol) 
pygame.draw.rect(screen, (0,0,0), (bel1X[n]+1 
@,160,be11X[n+1]-be11X[n]-20, 20) ,1) 


def drawSequence(): # display bell sequence 
screen.set clip(0,260,screenWidth,screenHig 
ht-260) 
screen.scroll(-30,0) 
screen.set clip(0,0,screenWidth,screenHight) 
for n in range(0,ringLength): 
t= 1; = C) 
while -1: 
if bellSequence[j] == lastSequence[n]: 
ie = 
j +=1 
pygame.draw.line(screen,trails[lastSequence[n] 
], (screenWidth-50,screenHight-16-n*24), (screenWidth- 
30,screenHight-16-t*24),4) 
pygame.draw.rect (screen, backC 
ol, (530, 227,179, 20) ,@) 
pygame.draw. rect (screen, backCol, (screenWidth- 
30,screenHight-200,16,191),0) 
for n in range(0,ringLength): 
drawwWords(str(bellSequence[n]+1) ,530+n*24, 227, 
(0,0,0),backCol) # horizontally 
drawwords(str(bellSequence[n]+1) , screenWi 
dth-30,screenHight-(n«1)*24,(0,0,0),backCol) # 
vertically 
pygame.display.update() 


def drawLables(): 

global textHeight 

textHeight = 26 

pygame.draw.rect (screen, backCol, (0,0, screenWidth, 
screenHight),0) 

for n in range(0,8): 

drawWords (str(n41),bellX[n]- 

4,0, (0,0,0) ,backCol) 

textHeight - 36 

drawWords("«---- Sequence 
----»",532,207,(0,0,0) ,backCol) 


def swing(bellNumber): # animated bell swing 
global bellState 
if bellState[bellNumber] : 
for pos in range(1,11): # swing one direction 
showBell(bellNumber,pos,pos-1) 
time.sleep(swingSpeed) 
bellState[bellNumber] = ð 
else: 
for pos in range(9,-1,-1): # swing the other 
direction 
showBell(bellNumber,pos,pos-1) 
time.sleep(swingSpeed) 
bellState[bellNumber] - 1 
samples[bellNumber].piay() # make sound 
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160. th,253),0) 
161. def showBell(bellNumber,seqNumber,lastBell): # show one 208. drawControls() 
frame of the bell 209. drawSequence() 
162. cRect = bells[bellNumber][lastBell].get_rect() 210. 
163. cRect.move ip((bellX[bellNumber]- 211. def handleMouse(pos): # look at click for swap positions 
plotPoints[bellNumber][lastBell][9], 212. global swapFrom 
164. hangY-plotPoints[bellNumber][lastBell] 213. if filePlay : 
[1]) ) 214. return 
165. pygame.draw.rect(screen,backCol,cRect,@) # clear last 215. update = False 
bell image 216. if pos[1] > 160 and pos[1] < 180: # swap click 
166. screen.blit(bells[bellNumber] 217. for b in range(0,ringLength-1): 
[seqNumber], (be1llX[bellNumber] 218. if pos[@] > бе11Х[0]+10 and pos[@] < 
167. -plotPoints[bellNumber][seqNumber] [2], bellX[b«1]«10 : 
168. hangY-plotPoints[bellNumber][seqNumber][1])) 219. swapFrom - b 
169. pygame.display.update() 220. update - True 
170. 2217 if update : 
171. def drawWords(words,x,y,col,backCol) : 222. drawControls() 
172. textSurface - pygame.Surface((14,textHeight)) 2237 pygame.display.update() 
173: textRect - textSurface.get rect() 224. 
174. textRect.left - x 225. def terminate(): # close down the program 
175. textRect.top - y 226. pygame.mixer.quit() 
176. textSurface - font.render(words, True, col, 227. pygame.quit() # close pygame 
backCol) 228. os. exit(1) 
177: screen.blit(textSurface, textRect) 229. 
178. 230. def checkForEvent(): # see if we need to quit 
179. def loadResources(): 231. global speed, running,ringLength, automatic 
180. global bells, plotPoints, bellState, samples, 232. event = pygame.event.poll() 
SwapIcon 2337 if event.type == pygame.QUIT : 
181. ре ае = бив 14 234. terminate() 
182. scale = [12.0,11.0,10.15,9.42,8.8,8.25,7.76,7.33] # 235. if event.type == pygame.KEYDOWN : 
size of bell 236. if event.key == pygame.K_ESCAPE : 
183. point = [(676, 63),(646, 73),(606, 73),(532, 237. terminate() 
Б) (4525 7DF 238. if event.key -- pygame.K RETURN and not filePlay: 
184. (380,67),(290, 71),(214, 61),(154, 57),(118, it reset sequence 
770 (AAA, 75) | 239. resetSequence() 
185. plotPoints = [] 240. if event.key > pygame.K_3 and event.key < 
186. bells = [] pygame.K_9 and not filePlay: 
187. for scaledBell in range(@,8):# get images of bells 241. ringLength = event.key & @x@f # number of 
and scale them bells 
188. plotPoint = [] 242. drawControls() 
189. bell = [ pygame.transform.smoothscale(pygame. 243. drawSequence() 
image. load( 244. if event.key == pygame.K a : # automatic swap 
190. "“swing/b"+str(b)+".png").convert_ 245. automatic = not(automatic) 
alpha(),(int(792.0/scale[scaledBell]), 246. if event.key == pygame.K г: 4 run bell 
191. int(792.0/scale[scaledBell]))) for b in 247. running - True 
range(0,11)] 248. if event.key == pygame.K s : # stop bells 
192. for p in range(0,11): 249. running - False 
193. pi = int(point[p][0] / scale[scaledBell]) 250. if event.key == pygame.K EQUALS : # reduce speed 
194. p2 - int(point[p][1] / scale[scaledBell]) 251. speed -= 0.04 
195. plotPoint.append((p1,p2)) 252. if speed « .08: 
196. bells.append(bell) 253. speed - .08 
197. plotPoints.append(plotPoint) 254. if event.key == pygame.K MINUS : # increase speed 
198. showBell(scaledBell,0,0) 2557 speed += 0.04 
199. samples = [pygame.mixer.Sound('sounds/"+str(pitch)+". 256. if event.key == pygame.K_c : # ring changes 
wav" 257. setMode(False) 
200. for pitch in гапре(0,8)] 258. if event.key == pygame.K_f : # play a file 
201. 259. setMode(True) 
202. def resetSequence(): 260. if event.type == pygame.MOUSEBUTTONDOWN : 
203. global bellSequence, swapFrom,lastSequence 261. handleMouse(pygame.mouse.get pos()) 
204. bellSequence = [0,1,2,3,4,5,6,7] 262. 
205. lastSequence = [0,1,2,3,4,5,6,7] 263. # Main program logic: 
206. swapFrom = -1 264. if name == ' main ': 
207. pygame.draw.rect(screen, backCol, (0,227, screenWid 265. main() 
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Eight queens successfully 
placed on a chessboard 
so that they don't threaten 
each other; this is just one 
possible solution 


SOLVE 
THE 


The same solution ona 
standard 2D chessboard 
diagram, which can be 
converted for the Sense 
HAT's display 


The green and red LEDs 
shown on the Sense HAT 
represent the board, and 

the white LEDs represent 
the queens. Other colours 
will also be used 


CHESS P 


Could you create a program to solve the eight queens puzzle for any size chessboard? 
If you can then you may be eligible to claim a one million dollar prize 


Raspberry Pi 
Sense HAT 
magpi.cc/ 
1TGGUt5 


Raspberry Pi 
Sense HAT 
emulator 
magpi.cc/ 
2bscvQk 


The eight 
queens puzzle 
on Wikipedia 
magpi.cc/ 
2iYCLGI 


The eight 
queens million 
dollar prize 
magpi.cc/ 
2BhNo1W 


his is not a joke or a scam. There really is a prize 
of one million dollars waiting to be claimed by 
anyone who can solve the puzzle of placing n 
queens on an nxn chess-board so that no two queens 
threaten each other (where n is any number taken from 
the set of positive integers greater than three). If you 
decide to take on this challenge then your program will 
also have to show whether an incomplete solution to the 
puzzle is a subset of a complete solution. For example, 
you will need to demonstrate whether a set of six queens 
placed on and 8x8 board is a subset of a solution to 
placing eight queens on the same board. 

If you're interested in the prize, then we'll show you 
how a Python program running on a Raspberry Pi with 
a Sense HAT can play eight queens as a game, solve the 
puzzle if you get stuck, and demonstrate whether an 
incomplete solution is a subset of a complete solution. 

Our program uses the LED matrix on a Raspberry Pi 
Sense HAT to represent a chessboard. The program 
will allow you to place and replace up to eight queens 
on the board in the quest to find a solution. If you get 
stuck with an incomplete solution, then the program 
will solve the puzzle for you and show you where you 
might have needed to move any of your queens to find a 
complete solution. 

Don't worry if you haven't got a Sense HAT on your 
Raspberry Pi: you can also run the program in the online 
Sense HAT emulator - just paste the code into it. 
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EIGHT QUEENS 


BLEM 


Can you solve the eight queens puzzle? 
Eight queens is usually played on a chessboard using 
eight chess pawns as surrogate queens. 

Placing queens on the board at random and expecting 
to find a solution is not a good way to play this game. 
There are nearly 4.5 billion ways in which it’s possible 
to place eight queens on a chessboard (4426165368 to 
be precise), but only 92 of these possibilities satisfy 
the requirement that no two queens can threaten each 
other. Although all 92 solutions appear to be unique, 
there are in fact only twelve truly unique solutions to 
the puzzle. The other 80 apparently unique solutions are 
transformations (rotations and reflections) of the twelve 
truly unique solutions. Quite clearly, we're going to need 
a better strategy than just having a go. 

When people play games like chess or draughts 
(checkers), they often use a combination of insight, 
cunning, and a game plan to defeat their opponent. One 
of the common strategies for these games is to control 
the middle of the board. This is quite a good way to play 
chess or draughts, but it's not the way to play eight 
queens. Eight queens is a game played by one person 
and there's no one to defeat. There has to be one queen, 
and only one queen, on every column and row of the 
board and for this reason the edges of the board can be 
just as important as the centre. We're going to need a 
different strategy – one that’s better suited to playing 
eight queens. 
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eight_queens.p у >PYTHON 3 


001. # Eight Queens by Gordon Horsington 
002. # Python 3 and Raspberry Pi Sense HAT DOWNLOAD: 
003. import sys, time, os magpi.cc/2krfFZq 
004. from sense hat import SenseHat 
005. sense - SenseHat() 

006. def main(): 


007. r = [92, 0, 0] 
a b 008. g = [0, 92, 0] 
009. yellow - [120, 120, 0] 
" ——À | ККЕ КЕ 010. blue = [0, 0, 120] 
igure 1 The knight's move is a useful strategy for placing А m 
queens on a board so that they don't threaten one another. The Ө nues ly о п] 
white queen in Figure 1a doesn't threaten any of the knights. 012. empty board - [ 
Remove the black knights from Figure 1a and replace the white ӨЛӨ Eg E); E, gn, 
knights with queens and we have an incomplete solution with 014. rg, nn grg, 
five of the eight queens on the board (Figure 1b) 015 E, E, E EP 
- S у PD 
Let's take look at chess and consider what happens E DE n BPB PB, 
i > . r r r r 
when a knight threatens a queen. There are eight peu LU 
Е : | 018. DE, E, S E, n, 
positions from which a knight can threaten a queen 019. Bn gengen»gern, 
near the centre of the board (Figure 1a) and the queen 020. г,Е,г,8,г,8,г,8] 
cannot retaliate by removing апу of the threatening 021. results = [[0],[e], [0], [e], [0], [e], [0], [0]. ] 
knights. Don't worry about there being eight knights ed Же ш ЕШ i ie 
the board - we're not playing chess, we're just Kee i Dat d 
[eia E М Playing й езе Ге 024. results[x].append(@) 
thinking about chess moves. Placing queens ona 025. find all(results) 
chessboard using the knight's move to separate them 026. game = [-1,-1,-1,-1,-1,-1,-1,-1] 
can be quite a good strategy for playing eight queens. 027. X, y, playing, display, midgame - 3, 4, True, False, False 
If you remove the black knights from Figure 1a and Bees а Сое 
: . Ё 029. sense.set pixel(x, y, blue) 
replace the four white knights with four queens, then 030 while playing: 
no two queens are threatening each other (Figure 1b). 031. for event in sense.stick.get events(): 
We have five queens on the board and an attractive 032. if event.action -- 'pressed': 
strategy. Unfortunately, as we'll see in a moment, 033. if event.direction == ‘up’: 
the five queens seen in Figure 1b are not part of a Ec .. y, midgame = increase(y) 
1 ТН 035. if event.direction -- 'down': 
complete solution. . 036. y, midgame - decrease(y) 
It doesn't matter where you place your first queen, 037. if event.direction == 'right': 
you can always use the knight's move to place a 038. x, midgame - decrease(x) 
second one. As we'll soon see, this tactic doesn’t 039. if event.direction == ‘left’: 
always succeed in placing all eight queens and quite сас нечо 
$ 041. if event.direction == ‘middle’: 
often you'll have to backtrack and move your queens 042 if display: 
around a bit before finding a solution, but it’s quite 043. playing = False 
a good strategy to keep in mind. Remember, even 044. else: 
though the knight’s move is useful, it’s not always 045. if good_move(game, x, y): 
sufficient to complete the puzzle (Figure 2, overleaf). A n midgame = True 
. егер 
А 048. best = find_best(game, results) 
How can the Raspberry Pi solve the 049. display - show answer(game, sense, white, 
eight queens puzzle using Python blue, yellow, results, best) 
and a Sense HAT? 050. if midgame: 
Using the knight’s move strategy is one way in which д5 а ока 
t ld tackle the puzzle, but it's not the Hid mS DEL урш) 
а COPE LEON ERE puzzle, й 1 053. display, midgame = show_game(game, sense, white, 
easiest nor the best one to translate into program code blue) 
because it won’t find all the possible solutions. When 054. sense.clear() 
you or I use this strategy, we tend to look at the board 055. sys.exit() 
and the placement of the queens as a whole; we look 056. def show answer(game, sense, white, blue, yellow, results, best): 
tth i 11 h d 057. for count in range(8): 
a ıe emp y squares as we ast e queens an | we use 058. Oe enolen] Боз OF 
our insight into the puzzle to find a good position for 059. sense.set pixel(count, game[count], blue) 
our next queen. If we get stuck then we can shuffle our 06e. for count in range(8): 
queens around, looking at the empty squares as well 061. if results[count][best] == game[count]: 
as the queens, and we can reposition the pieces taking HERE | EEG = ES 
А . else: 
our conceptual model of the problem into account. 06A shade - yellow 
Insight like this is difficult to define and, without 065. sense.set pixel(count, results[count][best], shade) 
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066. 
067. 
068. 
069. 
070. 
O: 
072. 
073. 
074. 
075. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
085. 
086. 
087. 
088. 
089. 
090. 
091. 
092. 
093. 
094. 


095. 
096. 
097. 
098. 
099. 
100. 
101. 
102. 
103- 
104. 
105. 
106. 
107. 
108. 
109. 
110. 
qud 
1127 
1137 
114. 
115; 
1167 
1172 
118. 
119 
120. 
121. 
1227 
1237 
124. 
1255 
126. 
127] 
128 
1297 
130. 
131. 
1327 
133; 
134. 


48 


def 


def 


game[count] = -1 
return True 


show_game(game, sense, white, blue): 
count = @ 
for column in range(8): 
if game[column] != -1: 
sense.set_pixel(column, game[column], white) 
count += 1 
if count == 8: 


for count in range(3): 
time.sleep(@.25) 
for column in range(8): 
sense.set_pixel(column, game[column], blue) 
time.sleep(0.25) 
for column in range(8): 
sense.set pixel(column, 
for column in range(8): 
game[column] = -1 
return True, False 
return False, False 
good_move(game, x, y): 
if game[x] == y: 
return False 
game[x] = y 
plus, minus = х + y, х - y 
for column in range(8): 
if column != x: 
row = game[column] 
if row == y or column + row == plus or column - row 


game[column], white) 


== minus: 


def 


def 


game[column] = -1 
return True 
find best(game, results): 
better - 0 
best - 0 
for count in range(92): 
good - 0 
for column in range(8): 
if results[column][count] -- game[column]: 
good +=1 
if good » better: 
better - good 
best - count 
return best 
find all(results): 
answer = [0,0,0,0,0,0,0,0] 
number, row, count, flag- 0, 0, 8, True 
while number « 92: 
if flag: 
row += 1 
flag = True 
last = row - 1 
answer[last] += 1 
if row == 1: 
answer[last] 
count -= 1 
if not answer[last]: 
break 
if answer[last] > 8: 
answer[last] = € 
row -= 1 
flag = False 
if flag and row != 1: 
flag = test(last, row, answer) 
if flag and row == 8: 
flag = False 
for column in range(8): 
results[column][number] = answer[column] - 1 
number += 1 


= count 


return 
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Figure 2 The knight's move can prove useful, but it's not always 
sufficient to place all eight queens on the board 


a clear definition, it's quite challenging to model it 
in program code. Perhaps using a neural network 
might be one approach to solving this problem and 
maybe, one day, this puzzle could be a suitable task 
for a quantum computer, but for today we'll look at 
how a straightforward Python program running on a 
Raspberry Pi can play eight queens and show us where 
we're going wrong if we get stuck. 

Let's take another look at the eight queens in 
Figure 2. Only eight of the 64 squares are occupied by 
queens and most of the board is empty. There's just 
one queen in every column and one queen in every 
row. Every solution to the eight queens puzzle has 
only one queen in every column and row and so we 
can represent the 2D chessboard in Figure 2 much 
more efficiently as a one-dimensional list with eight 
elements, rather than use a 2D list in which 56 of the 
64 elements are empty. We can use the index to our 
eight-element list to represent the columns of the 
chessboard, and a number stored in each element to 
represent the row in which the queen is placed. The 
2D LED matrix on the Sense HAT has its origin in the 
top left-hand corner and so the solution in Figure 2 
could be represented in a one-dimensional list as 
[7,1,3,0,6,4,2,5]. This reduction of a 2D chessboard to 
a one-dimensional list is the approach we have taken 
in our program. Note that board columns and rows 
are numbered from 0 to 7, not 1 to 8. So the zeroth 
element in the list stores the number 7 (the queen at 
the bottom left), and the first element the number 1. 

Finding all the possible solutions is now quite 
simple. All we have to do is make sure that every 
element of our one-dimensional list has a unique 
number in the range from 0 to 7 and this will ensure 
that the queens they represent do not threaten each 
other either vertically or horizontally. The queens 
can threaten each other diagonally and so we need to 
make sure that every number stored in the list does 
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not present a diagonal threat to any other number 
stored in the list. This again is quite easy to check. 
Let’s consider the list above which has the number 

3 stored in the second element. This means that 
neither the first nor the third element can be 2 or 4 

as this would represent a diagonal challenge to the 
second element. Similarly neither the zeroth nor the 
fourth element can be either 1 or 5, and so on for every 
element in the list. In this way the program eliminates 
a diagonal challenge to the queens. This reduces the 
number of possible solutions from 4.5 billion to a 
much more manageable 92, and the Python program 
can find all of them very quickly. The program can 
also determine whether an incomplete solution on 
which a player gets stuck is part of a complete solution 
by comparing a player's incomplete solution to all 92 
possible solutions. If an incomplete solution is not a 
subset of a complete solution, then the program finds 
the closest solution to the incomplete solution and 
shows the player where they were going wrong. 


Let's play eight queens 
on the Raspberry Pi 

The program runs on a Sense HAT or on an online 
Sense HAT emulator. All user interaction with the 
program is done using the Sense HAT mini joystick 
on a real Sense HAT, or the arrow keys and RETURN 
key on an emulator. In the rest of this description 
we’ll assume that a real Sense HAT is being used, but 
illustrate the puzzle with pictures from an emulator. 
When the program starts, you will see a 
representation of a chessboard with a blue cursor 
Figure 3a). You can move the cursor onto any 

empty square with the joystick and then press the 
joystick button to place a white queen over the cursor 
Figure 3b). Placing queens like this is the first of 
three roles for the joystick button. After placing a 
queen, the cursor can be moved to another empty 


u| vvi W 
u| yv LUV 


с 


Figure 3 The blue cursor (Figure 3a) is used to find a place fora 
queen on the board. Move the cursor with the joystick and press 
the joystick button to place a queen over the cursor (Figure 3b). 
This cursor will now be hidden by the queen, but it will reappear 
when it’s moved again by the joystick. It can then be moved 
around the empty squares (Figure 3c). The game is complete 
when there are eight queens on the board (Figure 3d) 
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135. def test(last, row, answer): 


136. while (last): 

137: column = answer[last -1] 

138. trial = answer[row -1] 

1392 if trial == column or trial == (column + row - last) or 
trial== (column - row + last): 

140. return False 

141. last -= 1 

142. return True 

143. def increase(square): 

144. if square > 0: 

145. square -= 1 

146. else: 

147. square = 7 

148. return square, True 

149. def decrease(square): 

150. if square < 7: 

1516 square += 1 

1527 else: 

153% square = 0 

154. return square, True 


"maine. 


155. if name  -- 
main() 


VV 


a b 


square and another queen can be placed over the 
cursor (Figure 3c). The program assumes that the 
latest move is the one you really want to make and 

if any queens are under threat from the latest move 
then the threatened queens will be removed from the 
board. This continues until there are eight queens on 
the board (Figure 3d). 

Let's suppose you get stuck and you want the 
computer to solve the puzzle for you. Move the cursor 
under any one of the queens already on the board and 
press the joystick button (Figure 4a). Asking for a 
solution in this way is the second use of the joystick 
button. The program will display the closest complete 
solution to your incomplete solution (Figure 4b). The 
white queens in Figure 4b represent the queens in 
your incomplete solution that were in the right place, 
the blue queens represent where your queens were in 
the wrong place, and the yellow queens are the ones 
you needed to place to complete the puzzle. If your 
incomplete solution is a subset of a complete solution, 
then there will be no blue queens on the board. If you 
move the cursor onto an empty square, then you can 
start another game. 

The third and last use of the central joystick button 
is to exit the program. Whenever there are eight 
queens on the board, you can move the cursor under 
a queen and press the joystick button to exit the 
program. This is much neater than using CTRL+C on 
the keyboard and it keeps all the interaction with the 
game on the Sense HAT joystick. 
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Figure 4 The 
incomplete puzzle 
in Figure 4a can be 
solved by moving 
the cursor under 
one of the queens 
and pressing the 
joystick button. 
The white queens 
in Figure 4b were 
placed correctly, 
the blue queens 
were in the wrong 
place, and the 
yellow queens 

are the ones you 
needed to place in 
order to complete 
the puzzle 
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Laura creates and maintains Raspberry 
Pi educational resources. Aside from 
computers, she loves cats, cakes, 
board games, and making jam. 
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EMORY GAME 


Create a memory game in Scratch where you need to remember 
the patterns of some Christmas jumpers 


emory games are quite fun and, as it turns out, 


> Scratch 2.0 simple to make in Scratch. In this game you 
; Е : : , + Stripes 
amen need to тетогіѕе the jazzy jumper, then click ‚ — 
(optional) on each part of the jumper template you’re shown to 
magpi.cc/ change the colours and recreate the jumper you’ve , Button 
2ATrxyb memorised. When you think you’ve got it, press the p 
button to see if you were right or not. = 
| —— Jumper 
Parts of the jumper / 
Open the starter project online (magpi.cc/2ihuixR) or Ё Picture 


— 


use the offline starter project (magpi.cc/2ATrxyb). 

If you are using Scratch online and you have a 
Scratch account, click on Remix in the top right-hand 
corner to save a copy of the project to your account. 


Take a look at the sprites in the project. You have Click on the Jumper sprite and then on the 
five sprites in total: one for each of the four parts Costumes tab. You will see three coloured costumes 
which make up the jumper, and one for the button. and a white ‘none’ costume (see Figure 03) 
(See Figures 01 and 02.) If you like, you can use the Fill tool to change the 
colours of the costumes. Change the names of the 
Sprites New sprite: ® / a costumes too, so that they match the new colours. 
Р | " . ^" However, make sure to leave the ‘none’ costume at 
Г 7? ? =" Э the bottom, and make sure it remains completely 
_ Stage Picture Trim Button white. This costume is shown when the player is 


trying to remember the jumper. 
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Scripts | Costum If you want to, you can change 
the colours or pictures of all four 
sprites which make up the jumper: 


Jumper, Stripes, Trim, and Picture. 


New costume: 


© / ш 


New jumper 

In this project there are a lot of 
sprites, and a good way of telling 
lots of sprites what to do is to send 
a broadcast. 

Let’s create a broadcast which 
tells the various sprites forming 
the jumper to each choose a 
random costume, so that they form 
a new jumper. 

Click on the Stage and make sure 
you are on the Scripts tab. The 
Stage is going to send a broadcast 
called new jumper to all of the other sprites. Think 
of this like a person with a megaphone giving 
instructions to lots of people at once. Add the code 
blocks from Figure 04 to the Stage scripts area. 

Now we need to let the sprites know what to do 
during this broadcast. Click on the Jumper sprite in 
the Sprites panel. Add the block in Figure 05 to the 
scripts for the Jumper sprite. 

You can tell the Jumper sprite exactly what to do 
when it hears the broadcast by attaching the blocks 
you want to happen below this block. 

When the Jumper sprite hears the broadcast, it 
should randomly pick one of the coloured costumes — 
but not the white one. 

Attach some code to yourwhen Т receive block to 
tell the Jumper sprite to pick a random costume out of 
the first three only (Figure 06). 

Click the green flag. Does the Jumper sprite colour 
change? Click the green flag a few more times to check. 
The colour might not change every single time you 
click the green flag, because sometimes the randomly 

chosen costume will be the same as the previous 
one. Now add some code to the Stripes, Picture, and 
Trim sprites so that, when they hear the broadcast 
new jumper, they also choose a random costume. 
(Hint: just use the same code as the Jumper sprite.) 


when clicked 


broadcast new jumper 


when I receive new jumper 


switch costume to pick random 69 to [3] 


when I receive new jumper 


wait €) secs 


broadcast hide jumper 


Hide the jumper 

The aim of the game is for the player to memorise 
the jumper, so you need to make it disappear after a 
few seconds. 

Go back to the Stage and add some code so that, 
when the Stage receives the new jumper broadcast, 
it waits for three seconds and then broadcasts a new 
hide jumper message (Figure 07) 

Switch to the Jumper sprite. Add some code so that, 
when this sprite hears the hide jumper broadcast, it 
switches to the blank ‘none’ costume (Figure 08). 

Add similar code to the other sprites making up the 
jumper. Click the green flag and test your code. Does 
the Jumper switch to all white with a question mark 
picture, three seconds after the green flag is clicked? 


What was on the jumper? 

So far, the program creates a random jumper for the 
player to remember, and then hides it. However, we've 
made a mistake! We didn't note down anywhere which 
costumes were randomly chosen, so how will we know 
if the player has recreated the jumper correctly? 

To save information you will need to use later on, 
you can create variables. Click on the Jumper sprite, 
then the Data block type, and create a variable 
called jumper. 

You're going to save the random costume that was 
chosen for the Jumper sprite inside this variable, so 
the program remembers it for later. 

Placeaset jumper block between the when I 
receive new jumper and switch costume blocks. 
We need to set the jumper variable to pick random 1 
to 3, so just drag that green block up to set jumper 
from the switch costume block below. Finally, alter 
the switch costume block to set it to the value of the 
jumper variable, which now holds a random number 
between 1 and 3 (Figure 09, overleaf). 


when I receive hide jumper 


switch costume to none 
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when 1 receive new jumper 


to pick random @ to Ө 


set 


switch costume to 


jumper 


jumper 


New costun 0) 


Click the green flag and check that your Jumper 
sprite still chooses a random colour each time. 

Create three more variables, one named after each 
other sprite making up the jumper. Add some code to 
the other three sprites so that their costume number 
is saved in the variable named after it. Your code will 
be slightly different for each sprite, because each 
sprite will have its own variable. 

Make sure that you hide the variables from the stage 
by right-clicking them and selecting hide (Figure 10), 
otherwise the game will be too easy for your player! 


Recreate the jumper 

The player needs to be able to recreate the jumper 
they saw by clicking on the different parts until they 
match the original one. 

Switch to the Jumper sprite and add some code so 
that, when the sprite is clicked on, it will display the 
next available costume (Figure 11). 

Add the same code to the other three sprites making 
up the Christmas jumper. 

Test your code by waiting for the blank jumper to 
display, and then clicking on the different parts. Do 
they change colour each time you click? 


HINT: if you accidentally drag the Jumper sprite, 
it'll come to the front and obscure the other 
sprites - to prevent this, you can add a go back 3 
layers block under its next costume block. 


The right jumper 

When the player thinks they have recreated the 
jumper correctly, they should click on the button to be 
told whether they were right or wrong. 


when this sprite clicked 


next costume 


Click on the Button sprite and take a look at its 
costumes (Figure 12). 

The ‘right’ and ‘wrong’ costumes will be used to 
display whether the player’s jumper was the same as 
the one that was displayed at the start. 

Add some code to the Button sprite so that, when 
it is clicked, it broadcasts a new message called check 
(see Figure 13). 

When the other sprites hear the message check, they 
should each check whether the current costume number 
is the same as the costume number saved in the variable 
named after them. If the costume numbers do not 
match, the sprites should broadcast the message wrong. 

Switch to the Jumper sprite and add some code to 
check whether the player selected the correct colour. 
If they were wrong, broadcast wrong (Figure 14). 

Note that you will need two green Operators blocks: 
one for not, and another one inside it for =. 

Add similar code to the other three sprites making 
up the jumper, but be careful to check the current 
costume number against the correct variable for that 
sprite. Now switch back to the Button sprite. 

We will assume the player is right unless we receive 
a broadcast saying they were wrong. Add a block after 
you broadcast check to switch to the ‘right’ costume 
(see Figure 15). 

Also add blocks to switch to the ‘wrong’ costume if 
the wrong broadcast is received (Figure 16). 

If any of the sprites making up the jumper 
broadcasts that its costume was wrong, the player will 
see the X. If not, they will see the V. 

Note that if you click the green flag again to restart, 
the Button sprite will stay as an X or W, so you may 
want to add some code to switch its costume to 
‘button’ when the green flag is clicked. 


when this sprite clicked 


broadcast check 


when Ireceive check 


if not costume # = jumper then 


broadcast wrong 


when this sprite clicked 


broadcast check 


switch costume to right 


when I receive wrong 


switch costume to wrong 
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CODING GAMES 
ON THE RASPBERRY PI 


Code::Blocks 


Some 
imagination 


A bit of patience 


Figure 1 

The Code::Blocks 
IDE lets you 
create a startup 
console C++ Hello 
World program 


Let’s dive into a subject that many people think is actually much 
harder than it is: game programming on the Raspberry Pi! 


espite its awesome success as a hobby 

system, the Raspberry Pi is seldom looked on 

as a machine that lets you write or play your 
own graphical games. There are emulators, of course, 
and those are a great introduction to the style of retro 
games most old-school coders cut their teeth on as 
spotty youths. However, you don’t see many original 
games written for the Pi, on the Pi, by Pi coders. Let’s 
try to change that. 

Game coding, on Raspberry Pi, in a professional 

language like C/C++ isn’t apparently very popular, 
but why? The Pi is more than capable of doing cool 


| stan here - code sto. 


Eu Code::Blocks 
a 


Recent projects 


o Recent files 
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graphics, has (nearly) all the tools needed on board, 
and just enough horsepower to easily create and run 
high-octane 2D games. It can even push a decent 
amount of polys around to create some quite exciting 
3D experiences. 

There's simply no reason not to write cool games 
on the Pi, so it's time we addressed this and introduce 
some new Pi coders to C++ and game coding, as well as 
alittle dabble with the Broadcom GPU. 

Over the next few issues, we'll outline a 2D game 
framework which you can explore and enhance to 
produce a range of 2D games. 
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CODING GAMES ON THE RASPBERRY PI IN C/C++ 


Let’s start with the first thing all new coders 
need to know, which is: DON’T PANIC! C/C++ isn’t 
as hard as people tend to think it is, especially if 
we Stick to core principles and concepts. It can get 
very complex very fast, but you can take your time 
and make progress at your own rate and still create 
cool things. 

But before we can use the language, we really 
need to have a development system known as an 
integrated development environment, or IDE for 
short; this contains all our code and lets us edit, 
build, and debug our code in one program. Of 
course, you can use multiple files and command- 
line systems, but IDEs are designed to make things 
easier, so let’s just use them. 

For this set of tutorials we’re going to use 
Code::Blocks, which you can find using sudo 
apt-get codeblocks in your Terminal window. 

Code::Blocks gives us access to a much more С++ 
friendly editor, compiler and debugger, and lets us 
run our code directly from the edit screen. Once 
installed, it appears in Programming tools (Figure 1). 


First steps 
Coders always start learning with the Hello World 
example, so we should do the same just to get used 
to our system. 

Setting up a new project as a C** Console App will 
produce a very simple single-file project. You can 
find the main.cpp file in the Sources filter on the 
left of your IDE screen; open up Sources and double- 
click on main.cpp to have a look at the file - it's only 
ten lines long. 

Main.cpp should be fairly understandable to a 
novice. There is a function, called main, and between 
its ( and ) brackets are two lines of code, one of 


Bue) E mou mose- 


Pinan cpp [HelloWorld 


ts | symbols 
Q Workspace 
Si HelloWorld 
B Source 
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which outputs some text; the other tells the function 1ш g 


to return to where it was called, in this case from 
the command line, ending the program. The using 
namespace will be explained later, but it’s a way for 
C++ to understand that the cout function, used to 
print text, lives in its ‘internal’ standard libraries. 

To make the program run we have two options: the 
green RUN arrow, or the Red Debug Arrow at the top 
of the Code::Blocks window. Press one; whichever 
you choose, you will find our project unsurprisingly 
prints ‘Hello World’ in what is called a console 
window, the black screen which pops up when our 
project starts. The console is very useful since it can 
allow us to output text to it and let us know what our 
project is doing at different points. 

Alter the "Hello World" text in the main.cpp, 
so long as the text is enclosed in " " marks, you can 
pretty much enter anything you like, you can even 
repeat the line a few times to add a few more choice 
text quips. Go on, make it swear at someone, you 
know you want to. 


>C++ 


NAME: 
main.cpp, 
SimpleObj.h/cpp, 


Game.h/cpp 


DOWNLOAD: 
magpi.cc/2jyodog 


The first thing all new coders 
need to know: DON'T PANIC! 
C/C++ isn't too hard 


Now that we have our project running, let’s see 
what Code::Blocks lets us do. Try left-clicking just 
after the number 7 on line 7 - a small red dot should 
appear (Figure 2); you can also right-click to get 
more choices. This red dot represents a break point: 
when our code is being debugged, it will stop. Run 
the project again, but using the red DEBUG arrow, 
which will force our project to compile and run in 


Figure 2 

Setting a breakpoint 
stops the project at 
that point 
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Figure 3 
Our Game 


class creates two 
SimpleObjs which 


56 


get updated 


| \Gamelcpp sHello Wordle СОЗ БОСКЕ 


main.cppX батеһи | SimpleObjhX | Game cpp X 


ts | Symbols 
О Workspace 
91 HelloWorld 


Simpledbj Bobby1 
SimpleOb) Bobby2 


Bobbyl.m MyName = "Bobbyl* 
Bobby2.m MyName = “Bobby2 


for (int i і < ie 


Bobby! update 
Bobby2. Update); 


return. 


Logs & others 


À Code:&locks X 


3X | # Build messages X 


debug mode. It will stop at the red dot, waiting for 
us to tell it to either continue or to step through the 
code using the icons next to the red arrow, which 
provide different step options for the code. More on 
that later, though. Code::Blocks gives a wide range 
of tools and functions to help us debug, but if this 

is your first time running it, not all of them will be 
visible - we will make them visible as our needs and 
experience increase. 


Time for bigger steps 
So, ‘Hello World’ is hardly the pinnacle of coding, but 
you’ve compiled and run your first project; it’s text 
only, but it’s our text and we love it. We might not be 
doing much, but we do know our tools work. Time to 
take things up a notch. 

C/C++ works by using code it already has, 
known as the standard libraries, and code that 
you write to make use of those libraries. There are 
other libraries we can use or even create ourselves, 
but one important thing to consider is that the 
main() function is the starting point of any 
C/C++ project. 


One important thing to consider 
is that the main() function is the 
starting point of any C/C++ project 


We could add hundreds of lines of code to our 
main() function to make it do something, but that's 
not really how С++ works. In fact, that's more how C 
Works, because this main function is in fact a small 
bit of C code, which brings us to why we persist in 
saying C/C++. 
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C++ is an enhancement to C, but inside C++ there 
are Still all the original C commands and concepts 
which we are free to use if we want to; it’s just that as 
C++ has become more and more stable and effective, 
we seldom rely on pure C any more, except to start up 
our project. 

C++ can mimic C all day long, but it would deny us 
the chance to make use of C++’s greatest trick: OOP, 
or object-oriented programming. 


What is ООР? 

OOP can be tricky to grasp straight away, but its best 
to think of it as a means to define a ‘thing’ that does 
‘something’, at the request of other ‘things’. 

We usually call these things objects, and we define 
them in concepts called classes. A class is C++’s way 
of describing something as a collection of functions 
and data which are usually personal to any individual 
instance of that class. Objects can be literally 
anything, and such a broad idea is where people tend 
to get stuck. 

We can create things, or classes, using a simple 
header file to define that class. We should start with 
a base class called Game, which is going to be our 
controlling class. We can let the main() function do 
a little setting up, but the sooner we leave it behind 
the better. 

Our Game class will be responsible for controlling 
all the other objects in our project, some of which 
will themselves have objects to control. But Game is 
the big cheese and its job is going to be to create and 
initialise the objects, control the calling of updates 
of those objects, and then to output or return the 
results of their efforts somewhere. Finally, when our 
project has run its course, it needs to return back to 
the main function, to let the program shut down. 
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ziHelloWord 


Figure 4 
And our two 


That's a lot to take in, so let's just try a simple bit 
of code to see how that works. 


Starting with C++ 
Almost all classes have a header file that’s unique to 
the class; check out Game.h, in our GitHub repo. 
We've defined the Game class as having three 
methods, two of which are standard, and one is 
something we will use to update all the systems it has. 
If we now look at how our new main function sets 
up a Game class, seen in main.cpp, just replace all the 
old code that was in Hello World. 
Main() now has an instance of a Game class; we 
use a special function called a constructor to set 
up some default variables, or not, as needed. Once 
main() creates a Game class, we then effectively 
pass the program control to Game and its Update( ) 
method - we'll only return to main() when we are 
done and want to exit back to the OS. Of course, at 
the moment, the actual code for Game has not been 
written; let's discuss that next. 
Now that our main function has passed control 
of our program to Game, it's up to Game to give us 
some ‘things’ to play with. Let's create some simple 
objects, called SimpleObj. Like the Game class, we 
define these in a header file, preferably using the 
same name as the class we define, Game.h. 


Ready to run 

These are just definitions at the moment; the 

header contains info on what the class is and what 

it contains. This SimpleObj has very little code; it 
has the constructor/destructor methods, which we'll 
discuss next time. More useful is the fact it also has 

a method called Update( ) and a function called 
Draw(), which currently does nothing; we'll add that 
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different objects 
now output some 
simple text 


soon. It has some variables, notably a string called 

m MyName, but that's empty when it is first created. 
Now that we have the definition of a SimpleObj 

class, we need to write the actual code, this time not 

in a header but in a CPP file. So, create a file called 

SimpleObj.cpp and then the Game.cpp file (Figure 3) 

and enter the code from the file in our GitHub repo 

- you could download this code, but it's better if you 

type it in and get used to making and fixing typos. 


So far so good 

We have code for Game and SimpleObj, so we should 
be able to compile this on our IDE. When next we run 
the code, Game has two new instances of SimpleObj 

– they're rather boring and dull, but they are there, 
and we include calls to their update() functions in 
the Game class’s main loop. They will be processed and 
print out little individual messages using their names 
to let you know they are there (Figure 4). 

So, two unique instances of SimpleOb;j are being 
updated by Game . Update( ), both defined by the same 
class definition, but unique instances with their own 
names. Try adding a third and see what happens. 

For now, that's as much as we can squeeze into this 
format, but next time we will expand our code to start 
working with graphics and the famous ‘hello triangle’ 
code that absolutely no one uses except game coders. 


LEARN TO CODE WITH C 


Enjoying using C and C++ and can't wait until next 
month for more? Check out our Essentials book, 
Learn to Code with C, for more C tutorials for 


beginners: magpi.cc/learn-c-book 
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FREQUENTLY 
ASKED QUESTIONS 


YOUR QUESTIONS ANSWERED 


NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


PORTABLE 
PI POWER 


58 


Mobile battery 

One of the easiest ways to portably power a Raspberry 
Pi is to use a Standard mobile phone battery charger. 
The Raspberry Pi isn’t all that power hungry, so it 
should last a while on even a lower-capacity battery, 
but make sure it’s capable of providing at least 2A 

of power 


Battery pack 

Normal AA batteries and the like can’t just be plugged 
into a Raspberry Pi. With the right HAT or adapter 
cable, however, you can use them to power a Pi. The 
adapters and HATs make sure the power output is 
consistent, as normal batteries have a habit of not 
working well on a low charge. 


Lithium batteries 

Adafruit does an excellent range of power adapter (and 
charger) boards that allow you to power a Raspberry 

Pi with a lithium-ion battery (magpi.cc/2AddAex). 
While a little more tricky to set up than a mobile 
charger or battery pack, the combo is small and can 
easily slip into your Pi project. 


Amps 

One of the most important things to think about 
when deciding on portable power options is making 
sure your solution can supply enough power to the 
Raspberry Pi. 2.5A is recommended for making full 
use of a Raspberry Pi 3. If you're not using the desktop 
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or any extra add-ons, however, you can get away with 
a slightly lower 2A supply. 


Charge 

Battery charge is measured in mAh (milliampere 
hours). High-capacity mobile phone battery chargers 
tend to come as high as 20000 mAh. These can charge 
your phones from empty about four to five times over, 
depending on your device, and will provide power 

to a Raspberry Pi for a very long time - we've heard 
reports of days. You will need to experiment to figure 
out how much you'll need, though. 


Size 

Not all projects are built the same, so the size of your 
power supply is an important factor. Smaller solutions 
will also naturally have less charge, meaning you'll 
have to swap them or charge them more regularly. 


Micro USB 

The most common way to power the Raspberry Pi is 
via the standard micro USB power port. All three of 
the main solutions we've highlighted will have ways 
of connecting via USB to power the Pi, although it does 
mean one extra cable in your setup. 


GPIO 

A more compact way of powering the Pi is via the 
GPIO pins. Some HAT mobile power solutions 
power the Pi via the GPIO, like the PiJuice HAT 
(magpi.cc/2B3WPIP). You need to be very careful 
with the power going to the GPIO pins, though - 

it needs to be consistent or you risk burning out the 
GPIO or even the Pi! 


USB pads 

A bit riskier, but you can always solder the 
individual wires of a USB cable to the connectors 
on the board. This allows you to save some space 
from the relatively bulky micro USB adapter. You 
need to be fairly confident with your soldering 
skills, though, or the wires may break loose at an 
inopportune moment. 
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FROM THE RASPBERRY PI FAQ 
RASPBERRYPI.ORG/HELP 


WHAT IS THE CAMERA MODULE? 

The Camera Module is a small PCB that 
connects to the CSI-2 camera port on the 
Raspberry Pi using a short ribbon cable. 

It provides connectivity for a camera 
capable of capturing still images or video 
recordings. The camera connects to the 
Image System Pipeline (ISP) in the Raspberry 
Pi's SoC, where the incoming camera data 
is processed and eventually converted to 
an image or video on the SD card (or other 
storage). You can read more about the 
Camera Module at magpi.cc/28ljlsz. 


WHAT IMAGE SENSOR DOES 

THE CAMERA MODULE USE? 

The Camera Module V2 uses a Sony IMX219, 
while the original Camera Module has an 


Omnivision OV5647. They are comparable to 
cameras used in mobile phones. 


WHAT RESOLUTIONS ARE SUPPORTED? 
The Camera Module V2 is capable of taking 
photos up to 8 megapixels (8MP). It supports 
1080p30, 720p60, and VGA9o video modes, 
as well as still capture. The original Camera 
Module is capable of taking photos up 

to 5 megapixels and can record video at 
resolutions up to 1080p30. 


WHICH PICTURE FORMATS 

ARE SUPPORTED? 

The Raspberry Pi Camera Module supports 
raw capturing (Bayer data direct from the 
sensor) or encoding as JPEG, PNG, GIF and 
BMP, uncompressed YUV, and uncompressed 


RGB photos. It can record video as H.264, 
baseline, main, and high-profile formats. 


HOW DO I USE THE CAMERA? 

There a number of command-line 
applications provided for stills and video 
output. These applications provide the 
typical features you might find on a compact 
camera, such as setting the image size, 
compression quality, exposure mode, and 
ISO. See the documentation for more details: 
magpi.cc/2egdAQA. 


CAN I EXTEND THE RIBBON CABLE? 

Yes. We have reports of people using 
cables up to 4 metres in length and still 
receiving acceptable images, although your 
experience may differ. 


INTRODUCING THE HOTTEST 
NEW PRODUCTS FOR YOUR PI 
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only at BuildPiper.com 


“Its a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff” Mii ө 
адр! 


Want їо learn how їо bring Piper to your school? 


buildpiper.com/EDU 


THE PIPER EXPERIENCE 
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ast month, we broke 
the news of Google’s 
all-new Vision Kit. This 


new AIY kit enables you to build 
an intelligent camera using a Pi 
Zero W and Camera Module. 

Of course, this being AIY, you 
can also use the hardware to add 
artificial intelligence to your 
own projects. 

The kit’s powerful VisionBonnet 
coupled with a Pi Camera doesn't 
just capture images of objects, 
it also identifies them. 

The Vision Kit is powered using 
TensorFlow's (tensorflow.org) 
machine learning models and 
can be trained to detect all 
kinds of things: cats, dogs, 
humans, household objects, 
even emotions such as smiling 
or frowning. 


We want to lift 
some of the magic 


away from AI 


This month, we're taking a 
closer look at the AIY Projects: 
Vision Kit hardware, software, 
and the possibilities it offers for 
integrating artificial intelligence 
with your projects. 

We're also going to look at the 
underlying techniques being used 
in artificial intelligence: artificial 
neurons and neural networks. 
We want to lift some of the magic 
away from AI and help you turn it 
into a tool for your project-making 
toolbox (albeit an incredibly 
cutting-edge tool). 

As with all AIY Projects, what's 
really interesting is how you 
can integrate Google's artificial 
intelligence into your projects. 

So be sure to get some 
inspiration for your projects, and 
share with us what you plan to 
make with Vision Kit. 
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ARTIFICIAL INTELLIGENCE 
Intelligence displayed by 
machines, in contrast with 
biological intelligence - the ‘Y’ 
in AIY stands for ‘Yourself’. 


ARTIFICIAL NEURON 

(AKA ‘PERCEPTRON’) 

A software function designed to 
mimic the behaviour of a neuron. 


COMPUTER VISION 

An application that analyses an 
image (or sequence of images) and 
extracts useful information. 


CONVOLUTIONAL 

NEURAL NETWORK 

A type of artificial neural network 
designed specifically for analysing 
visual imagery. 


DEEP LEARNING 

A subset of machine learning 
which is based on learning data 
representations (instead of task- 
specific algorithms). 


IMAGE CLASSIFICATION 

Taking an input image and 
inferring a class, such as a ‘cat’, 
‘dog’, or ‘human’. 


INFERENCE 

A probable conclusion reached 
on the basis of evidence and 
reasoning. The Vision Kit may 
take a look at an image of a cat, 
for example, and infer that the 
image contains... a cat. 


MACHINE LEARNING 

The field of computer science 
that gives computers the ability 
to learn without being explicitly 
programmed for tasks. 


I TERMS 


MACHINE INTELLIGENCE 
Artificial intelligence displayed 
by machines, as opposed to 
natural intelligence (displayed by 
humans). Typically used when AI 
is coupled with hardware. 


MACHINE VISION 

The technology and methods 

used to provide imaging-based 
automatic inspection and analysis. 


NEURAL NETWORK 

A connected system (built from 
connected nodes/neurons of 
data). Inspired by the biological 
neural networks that constitute 
animal brains. 


NEURON 

A biological cell that carries 
an electrical impulse. The 
human brain contains roughly 
100 billion neurons. 


NODE 

A basic unit used in computer 
science. Typically it's a single 
value, cluster of values, or 
function. Nodes are typically 
arranged into connected structures 
called graphs (or ‘binary trees’). 

In a neural network, the artificial 
neurons are connected together as 
nodes in a graph structure. 


OBJECT RECOGNITION 
Technology in the field of 
computer vision for finding 
and identifying objects. 


See Wikipedia's Glossary of 
Artificial Intelligence for more 


information: magpi.cc/2joDjjo 


SIONKIT 


à h hen you first get hold e» 


of your Vision Kit, 
you'll use it to set up a 
Smart Camera. This cardboard 


box has a camera lens, button, 
LED light, piezo buzzer, and a 

3 Privacy LED (so you can see when 
it's recording). 
АП you need is a Raspberry 
Pi Zero W, a Pi Camera Module 
V2, and a blank microSD card. 


A free Android app is coming 

soon to help you easily control 

your device. 
You will need a Pi Zero W with a 


GPIO pin header attached. You can 
solder the pins to your Pi Zero W, 


i or buy a pre-soldered Pi Zero W, 

such as this model from Pi Supply 
(magpi.cc/2BKwDsD). 

You'll need to download the 

Vision Kit SD image (available 

from the AIY Projects website, 

aiyprojects.withgoogle.com) 

and write it to the microSD card. 


ie] 


After it’s downloaded, write the 


= 


mage to your microSD card using 


А ы PEU 2 а card-writing utility such as 

[ | Etcher.io (see Burn SD Cards with 
cher, magpi.cc/2fZkyJD). 
While downloading the Vision 


í : х Kit SD image, you сап assemble 
v Bs the Vision Kit cardboard case. @ 
Wake Seas a fk е 2 We have some truncated steps 


ЗЕ A Me Be, overleaf, showing how the parts 


of the kit work together — the full 
i step-by-step guide can be found 
ATA on the AIY Projects website. 
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(1) VisionBonnet accessory board (x1) 

© 11mm plastic standoffs (x2) 

Ө 24mm RGB arcade button and nut (х1) 
14) Privacy LED (х1) 

Ө LED bezel («1) 

Ө V4"-20 flanged nut (х1) 


@ Lens, lens washer, and lens magnet («1) 
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© 127mm ribbon cable (х1) 
© Pi Zero camera flat flex cable (x1) 
€) MiPI flat flex cable (х1) 

@ Piezo buzzer («1) 

@ External cardboard box (х1) 


® Internal cardboard frame 
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With your Vision Kit set up, you’re ready to start exploring 


object detection with your Raspberry Pi 
ttaching a VisionBonnet to In particular, we'lllookataspecial the cutting-edge of modern 
ra f your Pi Zero W enables it type of artificial neural network technological developments. 
DO y ; | QS to perform machine vision called a ‘convolutional neura The good news is this: at the 
л 2 2. ich, т; tasks, where your projects сап network’. This is the data structure maker level, it is easy to add 
И » КЛ Bik infer objects, detect faces, or even that enables your Raspberry Pi to machine intelligence to your 
1 human emotions. perform image detection. projects. Google is providing 
O But what goes on under the This is a shallow introduction; a detailed API and models 
TE hood? In this part of the feature, dive a little deeper and you'll find which you can use to quickly 
Be we're going to take a very high- alot of mathematical structures, add image recognition to 
evel look at artificial intelligence interesting algorithms, and lots your projects. 
and neural networks that are and lots of connected data. A bit of understanding goes a 
Ё e based on our understanding of the It's dizzying to behold, but long way. So let's see what's going 
human brain. fascinating and sits right at on inside the VisionBonnet. 


Figure 1 


BIOLOGICAL NETWORK 


» 107 : In the human body, a neuron is an excitable cell which 

fas transmits information through electrical and chemical 
signals. The fundamental unit of the brain and nervous 

---------- system, it's responsible for receiving sensory input 
from the external world. 


ARTIFICIAL NEURON 


Inspired by biological 

systems, neurons have been 

roughly modelled in software 
Image courtesy of Rossenblatton Perceptron, Wikimedia (magpi.cc/2At6LoE) using algorithms. 


APT weights 
Ж AE ETERA, 5 inputs 
A ur. fas ; AREA do Xj 


E OG MEME TRANSFER FUNCTION 
activation 
functon 


Neural networks are formed by 
connecting artificial neurons like 
0; this together іп а computational 
activation graph. Pixels come in as input 
transfer values, and they are multiplied 
function by weights and a bias value is 
0; added. A computed value is then 
threshold passed to the next neuron. 


net input 
net; 
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object delection.py 


from PIL import Image 
from PIL import ImageDraw 


from aiy.vision.inference import ImageInference 
from aiy.vision.models import object detection 


def crop center(image): 
width, height - image.size 
size - min(width, height) 
X, y = (width - size) / 2, (height - size) / 2 
return image.crop((X, y, x + size, y + size)), (x, y) 


HIDDEN 


def main(): 

parser = argparse.ArgumentParser() 

parser.add argument('--input', '-i', dest='input', 
required-True) 

parser.add argument('--output', 
dest='output') 

args = parser.parse_args() 


-0', 


Figure 2 Artificial neurons 
(like the ones in Figure 1) are 


arranged as nodes in graph OUTPUT with ImageInference(object_detection.model()) as 


structures like this (typically А А 
with hundreds or thousands inference x р 
more nodes) image = Image.open(args.input) 
image center, offset = crop center(image) 


draw - ImageDraw.Draw(image) 
result - inference.run(image center) 


>STEP 01 >STEP 03 for i, obj in enumerate(object_detection.get_ 


Biological neuron Weights and biases objects(result, 0.3, offset)): 
Take a look at the top half of our So how does a perceptron know print('Object #%d: %s' % (i, str(obj))) 
Figure 1 on the left: biological and when to activate? Information p. y Шш» етпе = ові. Rounding рох А 
Жай АР | 57 raw.rectangle((x, у, x + width, у + height), 
artificial neurons. This is of course comes into the artificial neuron outline-'red') 
an example of a biological neuron. as floating-point numbers. It's if args.output: 
nformation arrives as a natural then multiplied by a weight (which image.save(args.output) 
electrical signal via the dendrites, is calculated and changes as the | "I 
and if enough signal arrives in the neuron is trained"). A bias number eria == main 
neuron via dendrites, a signal is is added and another mathematical 
passed on to other neurons via the function is used as an activation 
axon. Neurons are clustered together layer — it’s this number that is TENSORFLOW PLAYGROUND 
in the visual cortex to detect passed on to the next perceptron. 
different shapes and other visual A great way to get a visual understanding of neural 
information. The patterns formedby > STEP-04 networks is to use the TensorFlow Playground. This 
clusters of ‘firing’ neurons enable us Neural networks interactive website enables you to test out different 
to make sense of what we see. There are approximately 100 billion combinations of neural network elements against 
neurons in the human brain, so we datasets (blue and orange dots arranged in different 
>STEP 02 need plenty to make our machine patterns). You can see how adding features and 
Artificial neuron vision work. The artificial neurons hidden layers can make the neural network better at 
Artificial intelligence, famously are connected together to forma pattern recognition. 
known as АТ, attempts to mimic ‘Neural Network’ (Figure 2). The 
the behaviour of biological human input layers at the top represent playground.tensorflow.org 
neural networks using an artificial the data you start with (such as the 
neuron, which is known as a pixels in an image) and the output 
‘perceptron’. This is shown in the ayer is an estimate of the output 
lower half of Figure 1 on the left. such as a matching label, like ‘dog’ 
The perceptron also has inputs or ‘smile’). In between are hidden 
and outputs. Here, the inputs are ayers, which don’t see the whole 
typically a value from each pixel in network, just the previous and 
an image. next layers. 


LEARN MORE ABOUT 
NEURAL NETWORKS 


Here are some resources for learning more about 
artificial neurons, neural networks, and convolutional 
neural networks. 


Cats and dogs and 
convolutional neural 


networks 


Cats & dogs & convolutional neural networks 
A great coding example for building a cat and dog 
detector with TensorFlow. 

magpi.cc/2jl2qcU 


A Beginner's Guide To Understanding Convolutional Neural Networks 


A Beginner's Guide To Understanding 
Convolutional Neural Networks 

Athorough explanation of how neural networks work. 
This page outlines how they break down images into 
shapes to accurately detect different objects. 
magpi.cc/2jlUUhX 


Tensorflow and Deep Learning without a PhD 
A free resource from Google that takes you through 
the process of creating a neural network that can 
recognise handwritten digits. 

magpi.cc/2jlDdzk 


Complete Guide to TensorFlow 

for Deep Learning with Python 

If you're serious about learning more about how 
TensorFlow works and the creation of artificial neural 
networks, then this is the course to sign up for. It costs 
£20, but is often on sale, and can be picked up for as 
little as £10 if you're patient. 

magpi.cc/2jnE7LM 
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Feature maps 


Convolutions 


Subsampling 


Convolutions Subsampling Fully connected 


Figure 3 There are many different types of neural networks, specialised for different use cases. For computer 
vision and natural language processing, the most common type is the convolutional neural network (CNN). 
It breaks up images into small squares to identify common shapes and features (such as arcs, circles, dots, 
and lines). It's based on our understanding of the biological cortex. Image credit: Wikimedia 


>STEP-05 

Deep neural networks 

More layers give greater accuracy 
and also enable the artificial 
neural network to handle far more 
complex tasks. 

So in our artificial vision model, 
some layers could detect the edges 
of images; some could note things 
like eyes, or eyebrows, or lines of 
the face, or the curve of a smile. 

But there’s a performance trade- 
off. So designing a good neural 
network is a balancing act. 

If you have three or more layers, 
you get a deep neural network, 
which is where you get the term 
‘deep learning’ from. 


>STEP-06 

Biological neural network 
Getting back to the biological 
vision for a bit. Back in 1981, 

two professors named Hubel 
and Wiesel won the Nobel prize 
for studying the visual cortex in 
mammals. What they discovered 
was that neurons in the visual 
cortex have a small receptive field. 
They only look at small parts of 


what you see. They overlap to view 
the larger image. Different clusters 
of neurons are activated when they 
identify certain shapes: circles, 
horizontal lines, vertical lines, 
arcs, and so on. 


>STEP-07 


The convolutional 

neural network 

This brings us to the big discovery: 
the convolutional neural network. 
This was first outlined in 1998, 

in a paper called Gradient-Based 
Learning Applied to Document 
Recognition, by Yann LeCun and 
others (magpi.cc/2BHJ48A). The 
convolutional neural network 
mimics the biological neural network 
discovered by Hubel and Wiesel. 


>STEP-08 

Breaking it down 

Convolutional neural networks 

are designed specifically for image 
recognition. The CNN breaks down 
an image into increasingly small 
squares, called ‘convolutions’ or 
‘filters’, in a process known as 
‘subsampling’. See Figure 3, above. 


TENSORFLOW PROCESSING UNIT 


TensorFlow is a Google-sponsored 
software library used to develop 
neural network architectures, such 
as the convolutional neural network 
we've outlined here. 

Large sets of labelled data are 
used to train the network into a 
model for a purpose. 


Ф TensorFlow 


Google researchers have 
developed high-performance 
neural networks for image 
recognition, working best with 


specialised hardware. This 
hardware revolves around a tensor 
processing unit (TPU), an integrated 
circuit developed by Google 
specifically for machine learning. 
The chip on the VisionBonnet is 
acting as a TPU. 
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Each artificial neuron 
(perceptron) is connected toa 
small number of nearby neurons. 
These are grouped into small 
neighbourhoods that (like our 
biological neurons) detect shapes 
inside images: horizontal lines, 
arcs, circular dots, and so on. 


>STEP-09 

Training stage 

So now we have our convolutional 
neural network, how do we get 

it to detect cats from dogs, or 
know when a human is smiling or 
frowning? The network is trained 
using thousands of training images 
against known labels (such as 
‘dogs’ or ‘cats’) to create a model. 
This model is then tested against 
images it’s never seen before to 
see how accurate it is. If the model 
is any good, you can use it in 
your projects. 


>STEP-10 

Loading models 

For the most part, we expect folks 
to start by uploading models made 
by Google. Later you'll use models 
built by the community. Want a 
sheep-detector for your petting 
zoo? Need to keep an eye on a tool 
on a production line and know 
when it's about to fail? Just ask 
other members of the AIY Projects 
community to help. 

Google has already created three 
models that you can load onto your 
Vision Kit: a cat, dog, or human 
face detector; a human face and 
sentiment detector; and a model 
that identifies 1001 different 
commonplace objects. 


>STEP-11 

Follow the test code 
There are three pieces of example 
code in this feature related to AIY 
Vision Kit and your projects. The 
first two, object_detection.py 

and image_classification.py, 
accept an image file and infer 
objects or classify images. The 
third uses the Pi Camera and snaps 
a photo if it detects faces. Take 

a look to see what’s possible. 


ө ө ө 
image_classification.py 
import argparse 

from PIL import Image 


from aiy.vision.inference import ImageInference 
from aiy.vision.models import image classification 


def main(): 
parser - argparse.ArgumentParser() 
parser.add argument('--input', ' 
args = parser.parse args() 


-i', dest='input', required=True) 


with ImageInference(image classification.model()) as inference: 
image - Image.open(args.input) 
classes = image classification.get classes(inference.run(image)) 
for i, (label, score) in enumerate(classes): 
print('Result Xd: %s (prob=%f)' * (i, label, score)) 


from aiy.vision.inference import CameraInference 
from aiy.vision.models import face detection 
from picamera import PiCamera 


def main(): 
with PiCamera() as camera: 
camera.resolution - (1640, 922) 
camera.start preview() 


with CameraInference(face detection.model()) as inference: 
for result in inference.run(): 
if len(face detection.get faces(result)) »- 1: 
camera.capture('faces.jpg') 
break 


camera.stop preview() 
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anual 


Maker 
days 


A modular 


laptop that 
gives you 
the tools to 
complete 
amazing DIY 


projects 
pi-top 


Р] 


PIPER 
COMPUTER 
KIT 


А wooden 
computer and 
electronics kit 
with a built-in 
screen. Not 

a complete 
laptop, but a 
similar solution 
for teaching 
kids to code and 
use electronics. 


Д £299 / $299 
buildpiper.com 
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PI-TOP 


CEEDuniverse 
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he second-generation 
pi-top laptop is a device 
that has been long awaited 
by the Raspberry Pi team. While 
the first attempt was an interesting 
home-brew attempt to 3D-print 
a laptop, this is the point where it 
goes professional. 

Inside the box you get a pi-top 
housing, Inventor’s Kit, power 
supply and, of course, a Raspberry 
Pi 3 computer. 

The pi-top kit does require 
some assembly. The Raspberry Pi 
is screwed into place behind the 
keyboard. It takes up two USB ports, 
leaving two free and accessible from 
behind the laptop case. A Hub PCB 
slides to the right of the Raspberry 
Pi and hooks into the 3.5mm jack 
and HDMI socket. 

A metal Cooling Bridge bridges 
the gap between the Hub PCB and 
GPIO pins on the Raspberry Pi. It’s 
required to power the Raspberry Pi, 
however, and you can’t remove it 
and access the GPIO pins on your 
Raspberry Pi directly. 


The Cooling Bridge blocks off 
access to the GPIO pins, and 
prototyping takes place on the 
separate pi-topPROTO+ board 
(which has a pin breakout along 
with analogue pins). 

Setup is easy. Really easy. 

It literally takes five minutes. 
Obviously this is good in one 
respect, because it reduces the 
potential for problems. 

We can’t help wishing the 
build had slightly more to it. 
The keyboard, screen, trackpad, 
and battery all come in the pre- 
assembled kit and the assembly 
process felt vaguely superficial. 


Design notes 
There are some truly great touches 
to the design. Let’s start with 
its marquee feature, a sliding 
keyboard that moves down to 
reveal the inner components. 
It slides smoothly and clicks into 
either position. 

The chiclet-style keyboard is 
a joy to type on, with the same 


Vastly improved build 
quality and fantastic 
starter projects. 

By Lucy Hattersley 


level of quality you'd find on an 
Intel-based laptop. 

You can keep typing with the 
keyboard down thanks to a clever 
sliding cable system. And behind 
the keys lie two magnetic strips. 
Parts such as the PROTO+ and 
separate pi-topPULSE accessory 
clamp onto the rails. 

There's even a neat multi-tool 
accessory. One end is used as a 
screwdriver for the Raspberry Pi 
and Cooling Bridge. The other is a 
neat clamp that holds a microSD 
card so you can slide it in and out 
of the Raspberry Pi without having 
to remove the board. Clever stuff! 
We hope whoever designed the 
multi-tool got a pay rise. It also 
clamps on to the magnetic rail so 
you can take it with you. 

Above the keyboard sits a 
glorious 1920x1080 display. It’s a 
vast improvement on the previous 
model, and is surrounded bya 
nice bezel with rubber feet to hold 
it neatly against the keyboard 
when closed. 
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All of which is powered by a 
battery providing six to eight hours 
of life. We easily got a full day out 
of it, and it held charge for a week 
without losing all its power. 

Beneath the keyboard is a larger 
trackpad which - and it pains us to 
say this — sucks. It is sensitive to 
taps and brushes that frequently 


worksheets for everything 
from getting started to building 
electronics projects. Set up an 
account with pi-top and you get 
tracking stats for the number of 
lines of code you've created, and 
the worksheets you've completed. 
And you can always run 
Raspbian Stretch, which was 


The same level of quality you'd 
find on an Intel-based laptop 


move the cursor unintentionally. 
We ended up connecting a mouse 
instead of using the trackpad. 


PolarisOS 

Once everything is set up, you can 
start using the pi-top with the 
custom PolarisOS software. This is 
a custom build of Raspbian Jessie 
with extra software such as Google 
Drive and Google Docs. You also 
get neat extras such as Turtle ART 
and 3D Slash. 

Alongside Minecraft Pi and 
Python games is an extra offering 
called pi-topCEED Universe. This 
is aneat top-down adventure game 
where you have to use code to 
solve challenges. 

And there’s a built-in app called 
pi-topCODER. This contains 
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recently updated with pi-top extras 
such as a battery gauge. 


Is the price right? 
At £259 the pi-top is by no means 
extravagant in the laptop world. 
But it’s a far cry from the $35 
computer that the Raspberry Pi itself 
represents. Even at £259 you don’t 
get everything on offer. Accessories 
like the pi-topPULSE ($49.99) with 
an RGB matrix cost extra. You can 
even spend an extra $19.99 for 
a speaker, which isn’t included 
in the base package (although 
you can listen to sound using the 
headphone socket). 

Of course, buying a Linux 
laptop for the same price misses 
the point. Along with the pi-top 
you get a fantastic Inventor’s 


PI-TOP 


£260 / $319 


Kit containing LEDs, buttons, 
SH-SRo4 echolocation sensor, 
and a potentiometer. And you can 
prototype on a Raspberry Pi using 
the GPIO breakout pins on the pi- 
topPROTO+). 

And let’s not forget it includes 
Mathematica. For some people, 
this alone could be worth the price 
of admission. Mathematica costs 
£210 for a Home & Hobby licence. 
It’s free with Raspbian. 

The pi-top also contains three 
high-quality cardboard cut-out 
kits and a raft of software and 
workshops for kids. This enables 
kids to build a cardboard robot, 
spaceship, and music maker 
alongside learning basic coding and 
electronics skills. We think these 
are great projects that perfectly 
blend physical construction 
activity with coding. Well done! 


{ast word 


An amazing environment for kids to learn 


computing and digital making. And it's pretty 


good for adults who want to prototype Raspberry 
Pi projects on the move. Vastly improved upon 


the original pi-top, but still with quirks. We're 
taking off a star for the trackpad, but connect a 
mouse and this is the perfect laptop. 
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BEARABLES BADGE KIT 


le. Hackable. 
DM. Adorable. 


BADGE KIT 


CIRCUIT 


ied bios ПШ This light-up LED badge can be sewn onto clothes and triggered by a sensor 


NeoPixels has 
four built-in 
sensors, plus 
pads around 
the outside to 
connect others 
using crocodile 
clips. It's 
programmable 
on any 
computer 
(including the 
Pi) using the 
Arduino IDE. 


imoroni’s Bearables 

collection offers a choice of 

two cute animal LED badges 
¬ bear and fox - along with a couple 
of sensors that can be attached 
to them using conductive thread. 
While the badges and sensors are 
available separately, the complete 
kit includes either a bear badge with 
motion sensor, or a fox badge with 
light sensor. Both versions include 
a generous 3 metres of conductive 
thread, along with a CR2032 coin 
cell that provides 3-4 days of active 
use (i.e. when the badge is not in 
sleep mode). 

On its own, the badge can be 


£23 / $20 Bas һи operated manually by repeatedly 
magpi.cc/2jnRyu0 ^ А pressing the tiny button on the 
i Side MAE LUE e Р side to switch between 12 different 
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BEARABLES BADGE KIT ‘fteview 


£13 / $17 


A range 
of woodland- 
themed 
Sewable. Hackable. у wearable LED 
Wearable. Adorable. ы 

badges and 


sensors 
Pimoroni 


LED patterns: a good selection, sensor will then trigger the LEDs € ae 

s 4 А s А ackage j 

including chase lights and fades. through motion or lack of light, тарен everything 

The LEDs are single colour, butcome depending on its type. you need 

in six shades: blue, green, yellow, The badge can be hooked up toa Right Available in 

orange, red, and pink. There's Raspberry Pi via PC. This involves fox and bear styles, 
Peer r ; М the badges feature 

also the possibility of creating soldering wires (or a header) to 12 coloured LEDs 

your own custom patterns using metal pads on the rear of the 


a Raspberry Pi. badge and connecting them to 


The kit includes either a bear 
badge with motion sensor, or a y s 
fox badge with light sensor Б ا‎ jl. 


WI А 
When sewing the badge to the relevant GPIO pins. Helpfully, 
a garment or bag, you need to Pimoroni has created a Bearables 
connect each of its two metal hooks Python library (magpi.cc/2AcQ3H6) Tas word 
to one of those on the sensor. enabling you to control individual 
Polarity doesn't matter, but you LEDs and respond to button Excellent value for money, the badge kit has 
need to avoid the two lengths of presses. Since the badge hooks can everything you need to sew your interactive 
conductive thread touching. Getting read raw ADC values (0-255), they badge and sensor to clothes - although it should 
a good enough connection also should be usable with pretty much be noted that they don't like water, so don't put 
requires winding the thread fouror any analogue sensor. Not only that, them in the wash! Best of all, you can link the 
five times around each hook - it's but they can read GPIO pins pulled badge up to a Pi to create custom light patterns 
best to secure it with a blob of clear high or low, opening up all sorts and a whole lot more. 
nail varnish, too. Upon holding the ^ of possibilities for triggering LED 
badge button down, the attached patterns from the Pi. 
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Maker 
days 


Everyone 
will recognise 


and identify 
its familiar 


elements 
SB Components 


PITRAFFIC 


PITRAFFIC 


ey 


Эте д 


a ک‎ 


Build a working set of traffic lights and control them with code. By Lucy Hattersley 


etting up LED lights isa 
common starter project, so 
much so that we frequently 


CAMJAM 
EDUKIT 1 


It might only 
have three 
LEDs, but 
you build a 
traffic light 
yourself with 
jumper wires 
and resistors. 
Comes with a 
set of printable 
worksheets. 


£5 / $5 
magpi.cc/2ANOBwZ 


feature it in our beginner's guides. 
Just set up an LED and use a bit of 
code to turn a light on and off. 

It's common for educators to 
turn to traffic lights as inspiration 
for a quick follow-on project: LEDs 
are readily available in red, yellow 
(amber) and green. Students can see 
the relationship between the code 
they create and physical objects 
being controlled in the real world. 

Setting up traffic lights is a 
hassle, though. You need at least 
three LEDs for each light, plus a 
button if you're creating a pelican 
crossing. Setting up more than 
one set of lights quickly becomes 
a tangled bird's nest of wires, 
resistors, buttons, and LEDs. 
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The PiTraffic HAT solves this by 
placing four traffic light sticks on 
top of the board. It also features 
a button to one side, and a piezo 
buzzer in the middle of the traffic 
lights (so your pelican crossing can 
beep, just like in the real world). 

Setup is simple. Just plug the 
four traffic light sticks into the 
four sets of pins on top, and 
connect the PiTraffic HAT to the 
GPIO pins on any Raspberry Pi that 
has a 40- pin header. 

Then you should download test 
code from GitHub (git clone 
magpi.cc/2ymyx@E). 

After importing the PiTraffic 
code, you create instances of 
Traffic objects for each light, such 
as SouthRed = Traffic("SOUTH", 
"RED"). Once created, these are 
controlled using on() and of F() 


methods, such as SouthRed.on() 
and SouthRed. of f(). 

The only thing missing for us 
was Scratch support, which SB 
Components inform us is coming 
soon. The inclusion of Scratch 
will make this a compelling 
starter project for students. In the 
meantime we enjoyed using the 
Python API to code our lights. 


{ast word 


Agreat starter HAT that takes 
much of the tangle out of a 
classic project. Students can 


test out traffic light code and 
see their results running ina 
miniature recreation. 
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THE NEW 
MODERN MAKER 


E 


on the cover price 


HACK MAKE BUILD CREATE 


HackSpace 


TECHNOLOGY IN YOUR HANDS D 
CHOOSE, A 


USE THE 
RIGHT 


War 
rd 
Mun 


SINE WAVES CHEESE MAKING DIGITAL BRAILLE CR Er ter 


SOFTWARE 


ISSUE #02 


hsmag.cc 


й Available on the GETITON 
€ App Store P» Google Play 


Maker 
says 
This 

neat little 


RASPBERRY PI POWER SWITCH 


board adds a 
programmable 
power switch 
to your 
Raspberry Pi 


Nanomesher 


RASPBERRY PI 
POWER SWITCH 


Rob Zwetsloot looks at a simple, functional addition 


to the Raspberry Pi that goes the extra mile 


ne of the things we always 

hear about concerning the 

Raspberry Pi is that a lot of 
people would like it to have a power 
switch of some kind. There area 


The real magic of the board comes 
from the programmable ATtiny 
MCU controller. It's a completely 
hackable chip that sits on the Power 
Switch board but can be removed 


the chip and then replacing it on the 
board. Very simple. 

We like the design of the board, 
but we feel it would function better 
as some form of HAT, even if just 


PI SUPPLY few solutions for this you can try, and reprogrammed to provide other as an optional way to attach it to the 
SWITCH ranging from a simple USB switch to functionality with the remote. Raspberry Pi. Otherwise, the Power 
Asimilar bit custom, soldered-on buttons. This The catch is that you need to Switch works well enough and does 
of tech allows Raspberry Pi Power Switch is a little reprogram it via an Arduino- the job of being able to turn the Pi on 
ridi different, though. compatible platform like an Uno. or off safely. 

РУЛ ЛД: At least it сап be different - out of If you pay a bit more, you can get 

it just being the box you get a little circuit board these Arduino devices with the 

а куи that connects to the Raspberry Pi switch if you don’t already own one, (ast word 

ae ie GPIO, and also acts as a bridge tothe but you'll need to wire it up yourself Going beyond what you'd expect 
aremote. USB power. You сап then use it with to the Arduino with a breadboard. of a typical on/off switch by 


ЖК, 
£15 / $20 
magpi.cc/2Begq2Z 


the remote it comes with, along with 
some extra code you need to install 
yourself, to remotely power your Pi 
on and off with a press of a button. 
Nice and simple, and exactly what 
most people want. It’s small as well, 
so should slip into most projects. 
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You can hack it to recognise more 
signals from the included remote 
(or indeed any compatible remote), 
and even change the timings and 
function of the shutdown. Want a 
button in case you need to do a hard 
reset? You can add that by hacking 


making it hackable is a very 


novel idea. However, we feel 
like there could be some minor 
improvements to its connectivity. 
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RASPBERRY PI 
BESTSELLERS 


While Rails is less trendy, Ruby remains 
the cornerstone of much DevOps software. 


BEGINNING RUBY 
3RD EDITION 


Author: Peter Cooper 
Publisher: Apress 
Price: £29.50 

ISBN: 978-1484212790 
magpi.cc/2knB8pl 


Ruby, OOP, and good 
programming practice combined 
in a volume that touches on all 
the essentials from file handling 
through to documenting your 


code. A great intro for all, including 


coding beginners. 


RUBY RECIPES: A 


PROBLEM-SOLUTION  . 


APPROACH 


Author: Malay Mandal 
Publisher: Apress 
Price: £15.99 

ISBN: 978-1484224687 
magpi.cc/2koiJJp 


Cookbook-style collection of 
code snippets and short how- 
tos covering common scripting 
uses and teaching a fair bit of 
Ruby along the way in object- 
oriented and even functional 
programming style. 


TEST DRIVEN 
DEVELOPMENT 
IN RUBY 


Author: Bala Paranj 
Publisher: Apress 
Price: £31.99 

ISBN: 978-1484226377 
magpi.cc/2kqCK2c 


Aclear-sighted look at 
incorporating TDD into your 
coding workflow, based in 
Ruby, but strong on general 
principles that you'll be able 
to take away to Python and 
other languages. 
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A COMMON-SENSE 
GUIDE TO DATA 
STRUCTURES 

& ALGORITHMS 


Author: Jay Wengrow Bains 
Publisher: Pragmatic Bookshelf — 
Price: £36.99 

ISBN: 978-1680502442 


magpi.cc/2kritWm 


= 


Data structures and 
algorithms are what 
programming, essentially, is all 
about. While it’s easy to get started 
in coding, if you’ve not hada 
formal computer science education, 
or if time and other activities have 
dimmed the memories, Wengrow’s 
carefully structured guide aims to 
fill in the gap. 

It's also an essential subject if 
you've turned self-taught coding 
into a career, and have been 
flummoxed in a job interview when 
the questions turned to, say, BigO 
notation. We've reviewed a few 
algorithm books at either end of the 


THE PYTHON 3 
STANDARD LIBRARY 


BY EXAMPLE 


nan-Sense Guide to 


Tuctures and Algorithms | Other topics, should be 


technical spectrum, but this one 
is squarely in the middle, aimed 
at coders, but those lacking in the 
rigorous mathematical education. 
And the explanation 
of Big O, and many 


graspable by any who 

have struggled with 

denser books. 

Most importantly, 

this is a book witha 
practical purpose for 
programmers — speeding up your 
code. Having shown you how to 
understand and to measure the 
efficiency of your code, you’ ll see 
how the right algorithm and data 
structure for your project can make 
orders of magnitude of difference 
in the speed and scalability of 
a program. Clear explanations, 
essential theory, practical outcome 
— a great combination. 


Score 


intermediate-level developers who 
already have enough understanding 
of the language and its ways to 
follow along. The examples manage, 
through more than 1300 


mg - pages, to always hit the mark. 


Author: Doug Hellmann 
Publisher: Addison Wesley 


Price: £47.99 The Python 3 
ISBN: 978-0134291055 Standard Librar 
magpi.cc/2BNzRwq by Example 

The Python Standard 


Library is the ‘batteries 
included’ part of the language, 
giving the programmer a huge boost 
by providing them, inter alia, with 
modules for database connection, 
GUIs, networking, regular 
expressions, and unit tests. Doug 
Hellmann has long documented 
interesting and useful modules from 
the library in his popular Python 
Module of the Week (PyMOTW) blog, 
which led to the previous edition of 
this book. Blog and book are now 
both updated for Python 3. 

Modules get illustrated with 
code and discussion, aimed at 


Between Hellmann's clarity 
of thought and Python code’s 
general readability, this is a 
great learning resource. 
Note, there have been 
complaints about the code 
formatting of the e-book 
version, but the printed 
version (reviewed here) is correctly 
formatted. And this is a book that 
every Python programmer should 
have on their bookshelf, not just 
for reference, but to regularly take 
down and work through a Python 
module or three. Advanced abilities 
in Python consist largely of knowing 
what is available, and not wasting 
time reinventing work already done. 
An essential purchase. 


Score 


raspberrypi.org/magpi 


ACCESSIBILITY 


FOR EVERYONE 


# ^ BOOK APART 


Author: Laura Kalbag 
Publisher: A Book Apart 
Price: $37.50 

ISBN: 978-1937557614 
magpi.cc/2ksBlb9 


Laura Kalbog 


* Design decisions 
made in the name 
of accessibility 
generally benefit everyone, 
because all technology is 
assistive," says Kalbag, midway 
through this excellent look at 
the why and how of accessibility 
- atopic that seems to vex some 
projects and websites so much 
that they ignore it entirely! Those 
who don't access the world via 
screen, mouse, and keyboard in 
exactly the same fashion are often 
inadvertently sidelined. 
Fortunately, there are 
some relatively easy ideas to 
incorporate accessibility into 
your workflow: universal design 


R FOR EVERYONE 
AND EDITION 


Author: Jared P Lander 
Publisher: Addison Wesley 
Price: £24.99 

ISBN: 978-0134546926 
magpi.cc/2krzIKV 


While tremendously 
popular, in no small 
part thanks to the rapid growth 

in data science, R is not as easy to 
get started with as some languages 
— such as Python - thanks to its 
complexity. This is a language 

that can do much with statistics, 
algebra, and machine learning 

— but steering a path through to 
data science mastery in R, unless 
you have a lot of time on your 
hands, means knowing which bits 
to ignore. 

Basic mathematical use, data 
structures, and graphing tools 
precede programming basics 
like control flow, showing R’s 
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ACCESSIBILI 
FORE ЇЇ 


JARED P, LANDER 


makes a site easy to read and 
understand for everyone. We all, 
at different stages in our lives, 
“traffic between times 
of relative independence 
and dependence,” needing 
more or less assistance to 
see, hear, interact with, or 
understand a website or app. 
Foremost, setting up an 
accessibility policy - based 
on “extensive research into 
the needs of your target 
audience" - means that you 
have an agreed basis in the project 
for putting everyone's needs into 
each stage of the design. The 
practical and straightforward 
steps you can take - from 
content and design, through legal 
considerations, to testing - are 
outlined systematically by Kalbag, 
and always combined with a good 
dose of common sense. A timely 
look at an essential topic. 


Score 


strengths and main use cases. 

Following these come several 
chapters of practical 
data-led tutorials 
highlighting essential 

R packages, like dplyr 

and purrr, statistical 

and linear models, 
and techniques from 
data reshaping to 
K-means clustering. 

In R for Everyone, Lander 
takes you on a structured path 
through the 2096 or so of key R 
functionality which will enable 
you to manipulate and visualise 
data, and you won't feel short- 
changed by the time you reach the 
end. Lander combines the deep 
knowledge of a professional data 
scientist with the clear thinking of 
an experienced instructor. Nothing 
is oversimplified, but the confident 
beginner will be well rewarded. 


Score 


BOOKS 


ESSENTIAL READING: 
NEW YEAR RESOLUTIONS 


New Year, new opportunities - run straight 
towards them with eager embrace! 


Resolution: Get really organised! 


Getting Things Done: 

The Art of Stress-free Productivity 
Author: David Allen 

Publisher: Piatkus 

Price: £13.99 

ISBN: 978-0349408941 
magpi.cc/2krx5Jd 


Betting Things Done 


the art of stress-free 


The productivity method that will keep 
your inbox empty, and your mind free to be creative. 


Resolution: Think functionally! 


The Little Schemer 

Authors: Daniel P Friedman 
& Matthias Felleisen 

Publisher: MIT Press 

Price: £32.95 

ISBN: 978-0262560993 

magpi.cc/2kpSfHJ 


Make this year the one you learn to truly understan 
recursion, functional thinking, and the basics of Lisp. 


Resolution: Learn a dead language! 


Learn Latin "LEARN LATIN 
Author: Peter Jones тыынар 
око SERIES 


Publisher: Gerald Duckworth 
Price: $14.99 

ISBN: 978-0715627570 
magpi.cc/2kpomad 


Latin gives us many scientific root words, -PETER JONES ; 
has a lovely logical structure, and learning - 


it will stimulate your brain. 


Resolution: Become an algorithm adept! 


The Art of 
Computer Programming 
Author: Donald Knuth 
Publisher: Addison Wesley 
Price: £150 

ISBN: 978-0321751041 
magpi.cc/2krFKv4 


Start your heroic struggle to really LU 
understand computer science, with the Turin 
Award-winning master of algorithms, Knuth. 


Resolution: Get outside everyday 


Permaculture in Pots ui уос 
'Perniaculture 
Author: Juliet Kemp RP TS 
Publisher: Permanent Publications 1 : 
Price: £12.95 

ISBN: 978-1856230971 
magpi.cc/2kpoXZv 


Take a screen break; connect with the 
SoiL and elements for a few minutes, 
and grow some tasty food. 
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POWERED BY PI 


Lowering the costs of a university’s student service was only one of the 
benefits that Aneet Narendranath gleaned from using the Pi 


verhauling internal is looking to be not only cost- 
computer systems can effective, but also an upgrade 
be hard, especially in over an existing system, as Aneet 
places where the systems are Narendranath explains to us. 
Data flow. vital. In the case of Michigan | 

of the system Tech ELC, replacing a proprietary Can you tell us about your Pi data 

that Aneet has ; P : ? 

аааз) data collection system — used collection system: 

tested by students — with Raspberry Pi At Michigan Tech as part of my 


Raspberry Pi: Reports will be auto-generated and available via ssh/ftp/webpage. Supplementary analysis 
code for MATLAB and Excel will be created for future. 


Student signs-in to 
receive help at ELC. 


Student 
NA 


[^X 


Р 
1 
1 
1 
1 
i 
L 
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responsibilities, I manage and 
direct the operations of the 
Engineering Learning Center (ELC). 
The ELC is an in-house tutoring 
resource that helps engineering 
students with concepts and concept 
applications for engineering 
problems that they encounter in 
homework assignments. The tutors 
in the ELC, who have the title 
‘coach’, are students themselves. 
At the ELC, we use peer-to-peer 
instruction as a method of teaching 
and learning. The purpose of the 
ELC is to allow engineering problem 
resolution through concept 
discussion amongst peers. 

At the ELC, I work with a certain 
yearly budget. The budget and the 
staffing of the ELC with coaches are 
coupled strongly. To ensure that we 
optimise our monetary resources 
through effective staffing, whilst 
ensuring that students receive 
help when they need it, is a 
(multidimensional mathematical) 
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Above This is а heat map of the ELC 
usage, processed on a Pi. It helps 
improve resource allocation 


challenge. To perform this 
optimisation, we need (or needed) 
to collect ELC usage data to 
visualise what courses, hours of 
the day, and days of the week the 
ELC is used the most by students. 
By collecting data over several 
semesters, we found patterns in 
ELC usage and that allowed us to 
make staffing decisions, thereby 
helping us balance our budget while 
assisting students. 

We have a proprietary ‘Learning 
Center Management System’ that 
we use currently. We are planning 
on replacing it with a Raspberry 
Pi-based (prototype) data collection 
alternative. In this Raspberry 
Pi system, data can be collected 
through an interface written in 
Bash and then analysed through 
Python and Octave scripts. This 
Raspberry Pi alternative is in its 
alpha version. The beta version will 
be deployed shortly. 


How did the idea come about? 

Our previous method of data 
collection, which was proprietary 
although effective, was not flexible 
and could not be automated for 
ELC-specific usage. This and its 
cost had us review other options. 1 
have personally used the Raspberry 
Pi to keep track of my house when 
I am away on vacation (like an IoT 
device). Given that I had already 
used it extensively at home and am 
fairly comfortable with the Pi and 
Linux Bash and Python scripting, I 
thought, why not write some code 
that is deployed on the Raspberry 
Рі and would help understand ELC 
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ANEET NARENDRANATH 


As its name suggests, Michigan Tech is 

a university that started as a school for 
teaching engineering, specifically miners. 
Over the years the course topics have 
increased, so while there's still a bit of 

an engineering and science focus in the 


usage? It would collect student data 
through an interface and churn out 
reports in automated fashion, in a 
form and shape as decided by the 
needs of the ELC. 


Why the Raspberry Pi? 

It is inexpensive but is still robust. 
For example, I have left my 
Raspberry Pi on, running this data 
collection code for 90 days with no 
issues. It allows for all the flexibility 
and power of a Linux computer, 
seeing as I run Raspbian. 


What hardware and software 

are you using? 

I have several Raspberry Pi Zero Ws 
running Raspbian/Jessie or Lite. I 
also have a few Raspberry Pi 3Bs 
in the system. The data collection 
software is a Bash script. The data 
analysis and post-processing 
program was written in Python 
(with NumPy, Matplotlib, and 
Pandas) and Octave. 


Have you had any interest from 
other universities? 

No, this is a project that is 

internal to our mechanical 
engineering department for now. 
There has been some interest from 
other departments on-campus at 
my university. 


Below Aneet has 
several Pi Zero Ws 
running Raspbian 
Jessie or Lite 


curriculum, you can also take courses in 
business, art, and social studies. Besides 
that, it's also a research university, so 
there's always a wide variety of research 
being done across the school at every 
level of learning. 


Do you have any online resources 
for people who might want to 
build their own? 

All of what I have is ‘software 
based’. I will eventually have a Git 
page dedicated to this project that 
others can fork from. 

The use of data-science tools to 
make staffing and optimisation 
decisions for our Learning Center 
is a relatively new venture. We 
hope to understand our Learning 
Center's usage better and be better 
prepared to help students. Learning 
Center staffing is a complex 
multidimensional problem, 
much like a complex ‘job shop 
scheduling! problem. It is neat that 
we have an internally developed 
Raspberry Pi-based interface to 
collect and analyse data in an 
automated manner. The robust 
nature of the Pi, its flexibility and 
automation, and its cost are some 
of the main reasons that this is 
being deployed at our ELC. 


Eod es 
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THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 


s we write this issue slap-bang in the middle 

of December, members of the community are 

revealing their amazing Christmas-themed 
projects and Pi decorations. We love some special 
festive projects here at The MagPi, so here are some 
of our faves! 


Qc SI 


1g to @TheMagP1 


Don't have a tree so I'm adding network- 
controllable LEDs to a bookshelf: 


Sometimes you have to work with what you’ve got, 

so we like the idea behind this LED-lit bookshelf with 
controllable colours. Useful at any time of the year, 
and festive when you want it to be. 
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A fun little decoration by regular contributor Gareth 
Halfacree. We think it's cute and we also love the 
wooden frame - a perfect little geeky decoration to 
keep at your work desk, we say! 


АЙ). Gareth Halfacree [ Following | v 
> @ghalfacree 


Replying to @TheMagP1 
Just re-purposed my @pimoroni Unicorn Hat 


powered home energy monitor into an 
animated Xmas tree, because why not? 
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We love The Pi Hut’s 3D Xmas Tree kit, but we must 
admit we never thought about using it in this way! 
You probably shouldn’t shake it, though, otherwise 
the Pi might fly around the enclosure. 


E c» 


Replying to @TheMagP1 


My PiZeroW and @pihut XmasTree snow 
globe (snow machine and Sleigh Cam live 
stream yet to be turned on). May add a 
XmasTree Lights remote UI 


Spencer Organ decided to let you control his snow 
globe. It looks out for specific keywords in his Twitter 
mentions and lights up accordingly! It’s a great little 
visual reminder of incoming tweets and generally a 
lovely looking project! 


3 $ Organ pre 
I'm really excited to share my Christmas 
@Raspberry_Pi @TheMagP1 @pimoroni 
project. If I get a mention with snow, party or 
Christmas my snow-globe will respond with 
different lighting effects. Full details, build 
guide and code 
themakercupboard.space/projects/pi fi ... 
Tu 


Yes, we all know Die Hard is a Christmas 
movie. That battle has been won. Last year a 
viral image was making the rounds of a John 
McClane Christmas decoration, which was 
pretty fun, but reddit user rj45jack decided to 
take it one step further and make it with a Pi 
and a screen. It’s a bit brighter that way. 
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Community. FEATURE 


KICKSTART THIS! 


Raspberry Pi projects you can crowdfund this month 


DOCKING HUB for PI ZERO 
5 x USB Port + Ethernet + Audio 


PiTalk 


First Ever ча 
SMARTPHONE D. 
on b. 
Raspberry Pi e 


| 


PITALK PI ZERO DOCKING HUB 


This is a kit that will turn your Raspberry Pi into a This nice-looking project also has a very succinct 
smartphone! It’s by SB Components, which has an description: “The Pi Zero USB Docking Hub is a 
excellent history of making top-quality Raspberry Pi stackable USB hub that comes with five USB 2.0 
kits, and we don’t expect this to be any different. Due data and charging ports, a micro USB port for power 


to the mobile data service integrated into it, you can input, an RJ45 port for Ethernet, and a 3.5 mm 
easily use it for IoT applications for which you might audio input/output jack. Installation would take 
not have WiFi access. only seconds." 


BES BOE THE RESE ик 
we saw this month 


' mL magpi.cc/2ATFbjQ 


R 
Emulation of Eighties and Nineties 


P 
consoles on modern TVs can be very ы 

Я : D : 4 
contentious due to how scanlines i ө ө ш 


\ 
change the way games look. Raspberry 

Pis do have an analogue video out port, 

though, so Reddit user cadmiumredlight 

made use of that and installed a Pi 3 

inside an old CRT TV. Perfect emulation. 


ROOMBA- : | | [| ! p magpi.cc/2AUBZo7 
CHASING DRONE E 


Aldo Vargas built a drone that could 
visually identify and then automatically : 
track a Roomba. Why? Well, the coding Amazing. Don't like specific M&M colours? Instead 


behind it is quite complicated, and it's a | of asking you ‘why’, we'll just point you towards the 
pretty cool achievement. Plus, the video latest project from our friends at Dexter Industries: 
looks amazing as the drone chasesthe | an M&M sorter. It melds chocolate with LEGO and 


Roomba around a pathway outside. | = : Raspberry Pi, so it ticks every box imaginable. 
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BIG BIRTHDAY 9 
WEEKEND? г, 


The Raspberry Pi Foundation wants to put ona 


global celebration for its sixth birthday. “RASPBERRY 


Here’s how you can help 
A 9 


or the past few years, the Raspberry Pi a 
Foundation has held a community event in 
Cambridge around Raspberry Pi’s birthday, 
where people have come together for a huge party 
with talks, workshops, and more. Now they want 
more people to have the chance to join in with the 
birthday celebrations next year, so they’re going to ^ 
be coordinating Raspberry Jams all over the world 
to take place over the Raspberry Jam Big Birthday 
Weekend, 3-4 March 2018. Already registered? Here's 
what you need to do next. m! | 


What do you need to do? 

At this point, you should be looking for a venue, and 
aiming to book the date as soon as possible. Don’t 
leave it too late, or you might have difficulty securing 
a location. If you need some advice on finding 


a 


NEED HELP 


a venue, refer to the appropriate section in the 
лае Guidebook (magpi.cc/2q9DHfQ). STARTING A JAM? 
e 4 Опсе you’ve done that, you should create a sign-up 
page for your event (on Eventbrite, for example). 
Then you can submit your event to the Jam map 
(rpf.io/jam), and start to publicise it locally. 
We’re planning to produce some limited-edition 
eT ‘tour’ T-shirts for the Big Birthday Weekend and 
BRNG we'd like to include as many Jams as possible on the 


> back print. To make sure your event gets included, 
submit your Jam to the map as soon as possible. 


Stay connected 
If you're not already a member, you might find it 
useful to join the Raspberry Jam community on Slack 
2 \ = (slack.com), where Jam organisers share ideas and 
-F help each other. Just email jam@raspberrypi.org to 
request an invitation to join. 
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Web developer by day, resuscitator 
of retro technology by night. 
Meet Matt ‘Circuitbeard’ Brailsford 


y day, Barnsley-based 
Matt Brailsford is the 
owner of Outfield Digital, 
a web development business 
where he spends his time creating 
sites using .NET CMS Umbraco. 
By night, he's Circuitbeard, toy 
hacker and nostalgia reigniter. 

“1 draw a lot of inspiration 
from my childhood and the tech 
and toys I used to play with as 
a child," Matt explains when 
discussing his hobby of hacking 
and upgrading old toys. “I find it 
fun to take things and reimagine 
them as they might have been 
had the original designers had the 
modern technology we have at our 
fingertips today." 

The maker community became 
aware of Matt's hacking skills back 
in 2014 when a video of his NFC 


Inspired by Frederick Vandenbosch, 
Matt's Zero USB Hub is a neat and tidy 
means to easily access standard ports on 
the smaller board: magpi.cc/2BiEgix 


Spotify media server began to make 
the rounds across social media and 
news sites. “Опе of my first makes 
was a cassette player converted 
into a Spotify player, which used 
cassette tapes containing NFC tags 
to choose the playlist." 

No stranger to the pages of 
The MagPi magazine, Matt's 
projects have been featured before, 
including his recent Out Run 
arcade game using the Tomy 
Turnin? Turbo Dashboard toy that 
was originally released in 1983. By 
implementing a new LCD screen 
and hijacking the controls for the 
original game, Matt was able to 
turn the toy into a game-emulating 
arcade machine. And it was a true 
test of his skills to create. “The 
project itself was quite a big one for 
me, filled with several moments 


By hacking a Grandstand Scramble 
machine to create the ROMBUS3000, Matt 
started his arcade building journey using 
hacked toys and parts: magpi.cc/2zYPhoy 
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of frustration, from burnt-out 
potentiometers, to soldering LEDs 
backwards, multiple TFT screen 
purchases, and more...” 
Alongside his Out Run project, 
Matt has also produced several 
bartop arcade machines, again 
taking their inspiration from past 
toys and tech. And, most recently, 
he took Google’s AIY Projects voice 
assistant to a new level, installing 
it within the body of the iconic 
Tomy Mr Money. Lacking the 
Voice Kit given away by The MagPi, 
Matt decided to use the Pimoroni 
Speaker pHAT and a Raspberry Pi 


I draw a lot of inspiration 
from my childhood and the 
tech and toys I used to play 
with as a child 


Zero W, both small enough to fit 
within the restrictive body of the 
money-eating gadget. “Rather 
than just creating a plain old 
box for it, I decided to repurpose 
another beloved '80s toy of mine.” 
Outside of his hobbyist 
workspace, Matt also runs a local 
makerspace in Barnsley, called 
Barnsley.IO, and travels to Maker 
Faires in order to meet other 
like-minded makers and explore 
future releases. And if hacking, 
website-building, and makespace 
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MATT 'CIRCUITBEARD' BRAILSFORD 


magpi.cc/2zWRgSX 


Above Matt gained recent social media 
praise for his hack of a car toy to turn it into 
an Out Run arcade machine, complete with 
functional steering wheel 


management aren't enough for 
you, he's also working hard to 
produce Things Network, an open 
initiative to bring a free-to-use, 
long-range IoT network to his 
local community. “The hope is it 
will bring new opportunities to 
local businesses and open up a 
new era in digital manufacturing." 
And as for the future? “I’ve got 
a few projects Ра like to build and 


some skills I'd like to improve,” youtu.be/dX4rxSc7nno 


Matt reveals. Set to build his own 
mini pinball table, Matt would also 
like to work on his 3D- printing 
skills. “I’ve had one for a couple 
of years now and I’ve used it to 
build some components for my 
makes, but I’ve never really been 
impressed with my results.” 

Inspired by makers like Colin 
Furze and Love Hultén, and set to 
dial in his maker skills to produce 
more builds in 2018, we’re 
excited to see where the future 
takes Circuitbeard. 


magpi.cc/2jorYgA 
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Community EVENTS 


EVENT CALENDAR 


Find out what community-organised, Raspberry 
Pi-themed events are happening near you... 


Want a Raspberry Jam in 
your area? Want to start one? 
Email Ben Nuttall about it: 
ben@raspberrypi.org 


OXFORD RASPBERRY JAM 

When: Saturday 27 January 

Where: Oxfordshire County Library, 
Oxford, UK 

magpi.cc/2Am2h3y 

Whether you’re a beginner, family, 

or a committed enthusiast, the 

Oxford Jam team would love to 

see you at their first Jam. 


EXETER 

RASPBERRY JAM 

When: Saturday 6 January 

Where: Exeter Library, Exeter, UK 
magpi.cc/2Be2TZ6 

There will be lots to do, plenty of 
help and advice, and Pis to play 
with at the Exeter Raspberry Jam - 
head south-west! 
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REGULAR EVENTS 


PRESTON RASPBERRY JAM CORNWALL TECH JAM 

When: Monday 8 January When: Saturday 13 January 

Where: Media Factory Building, Where: Penwith College, Penzance, UK 
Preston, UK cornwalltechjam.uk 

magpi.cc/2Bcto2L For anyone interested in 

Preston Raspberry Jam is a technology, of all ages and abilities. 

community of folk who meet each Ask questions and learn about 

month to learn, create, and share programming in Scratch, Python, 

the potential of the Raspberry Pi. Minecraft, and much more. 


SWAB PI INTEREST GROUP MANCHESTER 

When: Wednesday 10 January RASPBERRY JAM 

Where: Roebuck Pub, When: Saturday 13 January 
Winchester, UK Where: The Shed, Manchester, UK 


magpi.cc/2AlS7QA 

Through this event, the hope is to 
share the excitement of technology 
with the programmers, engineers, 
and makers of the future. 


magpi.cc/1PgyqaY 

The Southampton, Winchester, 
Andover & Basingstoke Pi Interest 
Group is a relaxed event for playing 
around with Pi. 
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WE'VE HIGHLIGHTED SOME OF 
THE AREAS IN NEED OF A JAM! 
CAN YOU HELP OUT? 
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CORNWALL 
TECH JAM 


COTSWOLD RASPBERRY JAM 
When: Saturday 27 January 

Where: Park Campus, Cheltenham, UK 
cotswoldjam.org 

Taking place at the University 

of Gloucestershire, this event 


showcases the Raspberry Pi “We tend to visit other Jams to see what inspires 
computer and helps people to us. We then approach that person to come and 
learn all about it. run the same workshop at our Jam. As time goes 

on, we will try to focus more on children giving 
HULL RASPBERRY JAM the workshops.” 


When: Saturday 27 January Marcus Tyler-Moor 
Where: Hull Central Library, Hull, UK Horsham Raspberry Jam 
magpi.cc/2AlbDNb 

There'll be chances to get hands-on 
with more digital making activities 
through workshops and a hackspace 
area to share projects and give 
lightning talks. 


е JAN] 


Every Raspberry Jam is entitled to apply for a Jam 
starter kit, which includes magazine issues, printed 
worksheets, stickers, flyers, and more. Get the 
guidebook here: magpi.cc/209DHfQ 
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LETTERS 


DONATING OLD MAGPIS 


I saw the letter in the 
November issue about 
recycling old copies of 

The MagPi to go to makerspaces 
and such. 

Ihelp organise the Riverside 
Raspberry Pi user group in 
Riverside, CA. We probably 
don't have the funds to pay 
for shipping, but I would 
like to build a library of 
The MagPi issues for use by 
our members (any duplicates 
would be made available to 
our members to keep for free). 
So if you have people willing 
to ship them, we would gladly 
accept them. 

Depending on the response 
you got from this post, I could 
see there being many people 
wanting to donate, so maybe 
connecting us up to a select 


Raspberry Pi resources 

I've recently begun showing people the Raspberry 
Pi and how to use it. I really want to expand my 
repertoire on what I can demo with the Raspberry 
Pi, and any extra materials I can then send people 
so they can learn more. I don't suppose you 

could send us any spare issues of the magazine? 
Otherwise, what kind of resources can I find online? 
Karen 


Unfortunately, Karen, we don't get enough spare 
physical copies to do that. However, every issue of 
The MagPi is available for free online as a PDF. You can 
always get them printed it off if you want, or at least 
your favourite tutorials. 

As for other resources, the Raspberry Pi Foundation 
has a ton of free learning resources on its website, 
which you can find here: magpi.cc/1qEgoNh. 

There's alot of free learning to be had for the 
Raspberry Pi - take a look at these and see if there's 
anything worth giving folks you're showing the 
Pi off to! 


It's easy to get started with 
Raspberry Pi using our guides and 
online learning resources 
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number of people might be 
a good idea. 

Let me know what your 
thoughts are on this. 
Brian 


Since our initial letter in the 

magazine, you’re the first person 

to contact us about this, Brian. 

Unfortunately, we’ve had no 

offers from other people with 

used or unwanted issues, so 

we’re unable to help you with 

getting some issues at this time. 
However, we’ve started up 

a thread on the forum to try 

to encourage people to donate 

issues of The MagPi if they have 

any spare. At the moment 

it's an experiment, but do 

take a look on there and see if 

people are offering anything: 

magpi.cc/2BB4yZ1. 


RASPBERRY PI FOR NEWBIES 
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29 Eo | E = Ce 
FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving 
for the community - join in via 
raspberrypi.org/forums 


was just reading The MagPi and Iam The simple way to mount your Pi! 
really wanting the AIY Vision Kit! 


However, where will I be able to 
buy the kit in the UK? The AIY Voice Kit is e Industrial DIN rail mount 
only available for in-store pick-up, so I am н 
presuming the Vision Kit will be the same. * Ореп frame for better airflow 
Even if it is available for delivery, it will e Integ rated USB strain relief 
probably cost a fortune to ship it to the UK. 
KanoMaster22 


For the moment, the AIY Vision Kit is only be 
available from Micro Center, in the US. We know 
Google is planning to make more Vision Kit 
devices available in the next few months, and 
these will be available across the EU (including 
the UK). Make sure to pay attention to the mag 
to know when the kits go on general sale. Also, 
sign up to our mailing list so we can let you 
know as soon as possible: magpi.cc/Email-me. 


> cca 


"| 
The new AIY Vision 9 | | 
Kit is a smart 
camera, and a | 
sibling kit to the ©. 


Voice Kit that was і 


included with ү 
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START A CODE CLUB 
IN YOUR SCHOOL! 


Code Club is a network of volunteers and educators who 
run free coding clubs for young people aged 9-13. 


Our aim is to inspire the next generation to 
get excited about computer science and digital making. 


"We use Code Club's fun educational resources to run a 
weekly after-school club for Year 7 and Year 8 pupils. The 
| | students benefit considerably from the extra challenge!" 


Karen Dadd, Computing Teacher 


KA Code Club is free 


KA Code Club provides step-by-step guides for 
Scratch, Python, HTML, and Sonic Pi 


[A Code Club helps children develop skills including 
logical thinking, creativity, and resilience 


We have over 6000 clubs across the UK teaching 
more than 80,000 young people to code—come and join us!” 


Find out more at www.codeclub.org.uk 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 @ 


PI POE 


wy | О WITCH 
A НАТ KITS 


Learn more: 


Pi PoE Switch HAT 

Pi PoE Case 

TP-Link PoE injector 
Raspberry Pi3 & microSD card 


Three runner-up 
winners will get! 
Pi PoE Switch 
Pi PoE Case 


Three more runner-up 
winners will get! 


PoE Switch HAT 


Terms & Conditions 


Competition opens on 20 December 2017 and closes on 25 January 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the 
Raspberry Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering 
the competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from 
The MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and 


no cash alternative will be offered. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Column THE FINAL WORD 


MATT RICHARDSON 


Raspberry Pi community 


ow that it’s Christmas, a lot of people will 
find Raspberry Pis in their stocking or under 
the Christmas tree. And that means a lot of 
new users will join our community. If you’re among 
that group, Pm happy to welcome you to the world 
of Raspberry Pi! You're joining a massive community 
of enthusiasts with a wide range of skill levels, from 
complete beginners to computer experts. And there 
are so many possible ways to use Raspberry Pi that 
entering this community could feel a little daunting 
at first. I want you to feel comfortable as a new 
Raspberry Pi community member, so let me give you 
the lay of the land. 

Whether you plan to use our affordable computer 
for a particular project that you already have in 
mind or you hope to experiment and improve your 
computer skills, there's no shortage of support and 
inspiration out there. The fact that you're reading The 
MagPi is a great first step. Every month, you'll receive 
a well-curated selection of projects, community 
member profiles, and news from the Raspberry Pi 
community. I should point out that every issue of The 
MagPi is available as a free PDF download, so there's 
a huge catalogue of content to browse when you're 
looking for inspiration. 

If you need a daily fix of community updates, 
then be sure to check out the Raspberry Pi blog, 
which is featured at the top of raspberrypi.org. 
You can also stay up to date with us throughout the 
day by following the Raspberry Pi Foundation on 
Twitter, Facebook, YouTube, and Instagram. If you 
prefer email updates, then subscribe to Raspberry Pi 
Weekly, which is a digest of the week's news delivered 
straight to your inbox. 
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Matt Richardson is the Executive Director of the Raspberry 
Pi Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


” IHE LAY 
— OF THE LAND 


Matt Richardson welcomes new users to the 


For those of you who want to make and learn, 
we have a large collection of projects at 
projects.raspberrypi.org. These step-by-step guides 
are categorised by topics such as games, jokes, 
photography, and robots. They’re designed with 
learning in mind, so they don’t just tell you what to 
click or what to type. They guide you through the 
process of making a project, but they challenge you 
at the same time. Hints are available throughout the 
projects so although you'll be challenged, you'll never 
get stuck. These projects are the best way to explore 
the concepts of computing and digital making. 

If you run into any trouble getting started with the 
Pi, the Raspberry Pi forums are where you should turn 
for support. There are tons of community members 
who help each other out there. Keep in mind that 
there are over one million posts in the forum, so run 
a quick search before you post your own question... 
chances are someone has asked the exact same thing 
that you're trying to figure out. 

And our community members don't only meet 
online. They also get together in person at Raspberry 
Jams. These community-led events take many 
different forms, from just a few people meeting 
together to very large events with hundreds of people. 
To find a Jam near you, or to start your own, go to 
raspberrypi.org/jam. 

As you'll learn, the world of Raspberry Рі isa 
massive one, but it's rich with quality content, 

a supportive community, and no shortage of 
inspiration. I’m delighted to welcome you here and I 
hope you'll show the rest of the community what you 
make with Raspberry Pi. Merry Christmas and a very 
Happy New Year! 
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ТНЕ Official 
RASPBERRY PI 
EGINNERS BOOK 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adaptors 

8GB Micro SD card 

116-page beginner’s book 
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RASPBERRY PI 


The pocket-sized desktop computer! — — 8 
À PI ZERO 


store.rpipress.cc 


Сапа 


Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry pi board and case 
Power Supply and HDMI cable 


Available for worldwide shipping at: 
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Available in Europe 
through RS Components 


$89” £69? 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanaKit is a registered 
trademark of Cana Kit Corporation. 
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